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8 Other Installation Options 


Overview 


The following advanced options can help you upgrade or install NetWare® 
servers. 


Using NetWare Accelerated Upgrade 


You can run NetWare Accelerated Upgrade from a Windows* client 
workstation, so that you don’t need to be physically present at the server 
console. Although NetWare Accelerated Upgrade is quicker than the standard 
installation process, it does not install additional network products, licensing 
services, or license certificates. 


See Chapter 1, “Using NetWare Accelerated Upgrade,” on page 11. 


Automating the NetWare Installation with a Response 
File 


Installing the NetWare operating system software can be easier and more 
flexible when you use a response file. When used with the graphical server 
installation, a response file lets you 


+ Set and display specific defaults 
+ Bypass entire sections of the installation 


+ Automate the entire server installation process 


A response file is a text file containing sections and keys (similar to a 
Windows .INI file). You can create a response file using any ASCII text editor. 
If you use a response file, the NetWare server installation reads the installation 
parameters directly from the response file, replacing the default installation 
values with response file values. 


See Chapter 2, “Automating the NetWare Installation with a Response File,” 
on page 25. 
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Using Installation Scripts for NetWare Installation 


NetWare installation scripts let you 
+ Alter or extend the NetWare installation process 


¢ Install additional products or services on a NetWare server after the 
operating system has been installed 


See Chapter 3, “Installation Scripts for NetWare,” on page 101. 


Documentation Conventions 


In this documentation, a greater-than symbol (>) is used to separate actions 
within a step and items in a cross-reference path. 


Also, a trademark symbol e TM, etc.) denotes a Novell trademark. An asterisk 
(*) denotes a third-party trademark. 
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Using NetWare Accelerated Upgrade 


The NetWare® Accelerated Upgrade utility is an advanced utility that can be 
used to upgrade a NetWare 4.11, NetWare 4.2, or NetWare 5 server to NetWare 
6. NetWare Accelerated Upgrade is intended for use by network 
administrators who are skilled at troubleshooting and installing NetWare 
networks. 


WARNING: Back up all data before using this utility. Although NetWare 
Accelerated Upgrade can reduce the time required to upgrade multiple servers, it 
must be used carefully. There are no backout procedures that will restore your 
servers to their original configuration or restore trustee assignments if the upgrade 
is unsuccessful. 


Two advantages to using NetWare Accelerated Upgrade are that: 


+ Itruns on a Windows client workstation, so you don’t need to be 
physically present at the server console. You also have the option of 
customizing the NetWare Accelerated Upgrade script files, which allows 
you the flexibility of customizing the NetWare 6 installation. 


+ Itis quicker than the standard installation process; however, it does not 
install additional network products or licensing certificates. 


How NetWare Accelerated Upgrade Works 


NetWare Accelerated Upgrade requires a Windows client workstation, a 
staging server, and a NetWare 4 or 5 server targeted for upgrade. 


The staging server holds a copy of the NetWare 6 Operating System CD files. 
From this one location, all targeted servers can be upgraded. 
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NetWare 4 or 5 
targeted server 
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running 


NetWare Accelerated Upgrade Staging Server 


After the NetWare 6 Operating System CD files are copied to the staging 
server, you will log in to a Windows workstation and launch the NetWare 
Accelerated Upgrade utility (ACCUPGEXE), located at the root of the 
NetWare 6 Operating System CD. When NetWare Accelerated Upgrade 
launches, you will log in to the target and staging servers. 


During the upgrade, NetWare Accelerated Upgrade compares the existing 
target server properties, such as the Directory Services version and the CLIB 
version, with the minimum upgrade requirements for those properties. 


If you meet the minimum requirements, NetWare Accelerated Upgrade copies 
the NetWare 6 CD files from the staging server to the target server. After the 
file copy, the target server reboots to complete the NetWare 6 server upgrade. 


Before you begin upgrading the server, make sure that you have the following 
software: 


+ NetWare 6 Operating System CD 


+ NetWare 6 License/Cryptography diskette for each server plus five 
connections if you do not have an MLA 


12 Other Installation Options 


Upgrading to NetWare 6 


To run NetWare Accelerated Upgrade, complete the following tasks: 


l. 


Prepare the Workstation (page 13) 


2. Prepare a Staging Server (page 13) 
3. Prepare the Network (page 17) 

4. 
5 
6 


Prepare the Target Server (page 15) 


. Run NetWare Accelerated Upgrade (page 18) 
. Complete Post-Upgrade Tasks (page 20) 


Prepare the Workstation 
L) A Windows 95/98, Windows NT*, Windows 2000, or Windows ME 


workstation with 50 MB of available disk space. 


+ The Windows 95/98 and Windows ME workstations must be running 
Novell® Client™ version 3.3 or later and Support Pack 1 or later 


+ The Windows NT and Windows 2000 workstations must be running 
Novell Client for Windows version 4.8 or later and Support Pack 1 
or later 


UA PS/2* or serial mouse recommended, but not required. 


Continue with the next section, "Prepare a Staging Server." 


Prepare a Staging Server 


The staging server holds a copy of the NetWare 6 Operating System CD files. 
From this one location, all targeted servers can be upgraded. The staging 
server can be any server other than the server you plan to upgrade and the 
client workstation you are using to run NetWare Accelerated Upgrade. 


1 Do one of the following: 


+ Copy the NetWare 6 Operating System CD files to a volume on the 
staging server. Make sure that all target servers can access the staging 
server and the client workstation. 


+ Mount the NetWare 6 Operating System CD as a volume on the 
staging server. 
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2 (Conditional) If you are upgrading a target server that does not have NICI 
installed, copy the NetWare 6 NICI file to your target server. Do one of 
the following: 


+ Ifyou copied the NetWare 6 CD files in Step 1 on page 13, create 
directory named License at the root of the copied NetWare 6 
Operating System CD and then copy the #.NFK file from the 
NetWare 6 License/Cryptography diskette to the newly created 
License directory. 


+ Ifyou mounted the NetWare 6 Operating System CD, rename the 
#.NFK file to NICIFK (no extension is needed) and then copy the 
#.NFK to the SYS:SYSTEM directory on every target server that you 
plan to upgrade that does not have the NICI installed. 


3 (Optional) Specify disk drivers manually. 


Although not recommended, you can load disk drivers that are not 
provided on the NetWare 6 Operating System CD or bypass the hardware 
auto-detection used while running NetWare Accelerated Upgrade. For 
more information, see “Specifying Disk Drivers Manually” on page 20. 


4 (Optional) Customize the NetWare Accelerated Upgrade script files. 


WARNING: Customizing the installation process could affect the way that 
NetWare 6 is installed. This might result in an upgrade failure and might make your 
server unusable. 


Customizing script files lets you add more menu options or install 
additional software or patches that are not standard features of the 
NetWare 6 installation. 


For information on using script files, see "Upgrading an Enterprise Using 
the NetWare Accelerated Upgrade" (AppNotes, April 1999) at the Novell 
Developer Net Web site (http://developer.novell.com/research/ 
completearchive.htm). 


When the source server is ready, continue with the next section, "Prepare the 
Target Server." 
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Prepare the Target Server 


The target server is the NetWare 4 or NetWare 5 server that you plan to 
upgrade to NetWare 6. Make sure your target server meets the minimum 
requirements listed below. 


WARNING: Do not use NetWare Accelerated Upgrade to upgrade the first server 
in your tree to NetWare 6. You must already have a server running NetWare 6 in 
your tree in order to use NetWare Accelerated Upgrade. If you do not already have 
a server running NetWare 6, do an inplace upgrade on a server in your tree, and 
then upgrade the rest of the servers in your tree with NetWare Accelerated 
Upgrade. 


0 A server-class PC with Pentium* Pro or Pentium II or higher processor 
with a minimum of 180 MB of RAM. 512 MG of RAM is recommended. 


HINT: 180 MB is the minimum requirement. If you plan to install additional 
products after the upgrade, you might want to take into account the additional 
memory requirements those products will have and plan for them now. 


O Make sure the target server has enough disk space. 


+ 30 MB of available disk space on the DOS partition. The 
recommended total size of the DOS partition is 100 MB. 


+ 1 GB minimum available disk space on volume SYS:. However, the 
total recommended size of volume SYS: is 2 GB. 


U (Optional) Load the RSPX and REMOTE NLM™ programs (for the 
IPX™ protocol) or the RCONJAG6.NLM program (for the IP protocol) 
on the target server if you are using script files to upgrade your server and 
you want to see and access the target server?s server console from the 
client workstation. 


A (Conditional) If your target server is running ZENworks™ for Servers 2, 
you must unload this application before upgrading your server. For more 
information about upgrading servers with ZENworks, see ZENworks for 
Server 2 Installation and Setup Guide (http: //www.novell.com/ 
documentation/lg/zfs2/index.html) > Installing and Setting Up 
Management and Monitoring Services > Setting Up Management and 
Monitoring > Starting and Stopping Services. 


To stop the Policy and Distribution Services, follow these steps: 


+ Enter CTRL/ESC at the server console of the NetWare server to list 
the processes that are currently ruming. 


+ Select Distributor from the list. 
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+ 


+ 


Prompt enter Exit, at the Distributor console. 

Select Subscriber from the list. 

Prompt enter Exit, at the Subscriber console. 

Select ZENworks for Servers from the list. 

Prompt enter Exit, at the ZENworks for Servers console. 
Select Remote Web Console from the list. 


Prompt enter Exit, at the Remote Web Console. 


The following table lists the procedures that NetWare Accelerated Upgrade 
does not support during a NetWare 4 or NetWare 5 upgrade. 


Table 1 Unsupported Procedures When Upgrading a NetWare 4 or NetWare 5 Target Server 





Not Supported during an Upgrade Recommendation 
Adding the IP protocol during the Add the IP protocol after upgrading by 
upgrade using NetWare 6 utilities such as 


INETCFG, or use the NetWare 6 
Installation program to upgrade. 


Once you have met the hardware requirements, complete the following steps 
to prepare your target server to be upgraded: 


1 Update the target server with the latest NetWare Support Pack. 


Support Packs are available at the Novell Support Web site (http:// 
www.support.novell.com/filefinder). 


+ 


+ 


+ 


NetWare 4.11 and NetWare 4.2 require NetWare 4 Support Pack 8 
(IWSP6A. EXE) or later 


NetWare 5.0 requires NetWare 5 Support Pack 6 or later 
NetWare 5.1 requires NetWare 5 Support Pack 2 or later 


2 (Conditional) If you are upgrading a server in a multiserver tree that is 
running NDS® 7 with NSS volumes, do the following: 


2a 


2b 


Run the NetWare Deployment Manager utility (NWDEPLOY.EXE), 
located at the root of the NetWare 6 Operating System CD. 


Click Network Preparation > Prepare a Server with NDS 7 & NSS. 
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3 (Conditional) If you are upgrading a server in a multiserver tree that is 
clustered, do the following: 


3a Run the NetWare Deployment Manager utility (NWDEPLOY.EXE), 
located at the root of the NetWare 6 Operating System CD. 


3b Click Network Preparation > Prepare a Novell Cluster for Upgrade. 


4 Run DSREPAIR > Time Synchronization at the server console of the 
target server. If you encounter any NDS? synchronization errors, make 
sure you resolve these before continuing. 


5 Mount all volumes. 


If you have experienced disk errors in the past, you might want to run 
VREPAIR on all of the volumes on the server to ensure that there are no 
errors. 


6 Verify that your target server can communicate with your staging server 
and your client workstation. 


IMPORTANT: Make sure that the client workstation, target server, and staging 
server share the same protocol (IPX™ or IP). 


If you have problems here, refer to “Troubleshooting Server-to-Server 
Connections” on page 21. 


7 Make sure that you have the Supervisor right to the container where the 
target server resides. 


When the target server is ready, continue with the next section, "Prepare the 
Network." 


Prepare the Network 


Because you cannot use NetWare Accelerated Upgrade to upgrade the first 
server in a multiserver tree to NetWare 6, you must do an inplace upgrade on 
one server in your tree. Once there is a server in your tree running NetWare 6, 
you can safely upgrade the rest of your servers using NetWare Accelerated 
Upgrade. 


For instructions on performing an inplace upgrade, refer to Chapter 3, 
"Upgrade to NetWare 6" in the NetWare 6 Overview and Installation Guide. 


If you are upgrading a server in a single-server tree to NetWare 6, you can use 
NetWare Accelerated Upgrade; however, you will need to manually extend 
the NDS schema after the upgrade. If you want the schema updated 
automatically, it is best to do an inplace upgrade. 


Continue with the next section, "Run NetWare Accelerated Upgrade." 
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Run NetWare Accelerated Upgrade 


1 From your workstation, log in to the staging server and double-click the 
NetWare Accelerated Upgrade executable (ACCUPG.EXE), located at 
the root of the NetWare 6 Operating System CD. 


2 Read the Welcome screen and click the right-arrow. 


3 Enter the location where you copied or mounted the NetWare 6 files to the 
staging server and click the right-arrow. 


4 Enter the password to the staging server (the server that holds the copy of 
the NetWare 6 CD files) and click OK. 


5 Select your target server from the list and click the right-arrow. 


6 If prompted, enter the username, password, tree name and context for the 
target server, and then click OK. 


7 Click the right-arrow. 


At this point, NetWare Accelerated Upgrade checks the target server to 
make sure that the selected server meets the minimum software and 
hardware requirements of NetWare 6. This might take a few minutes. 


8 Review the critical requirement screen and make sure that the target 
server meets the minimum NetWare 6 server requirements. 


NOTE: If you have applied the Support Packs listed in the “Prepare the Target 
Server” on page 15, you won't have any problems meeting these requirements. 


Some items appearing on the list are not critical requirements. But the 
following requirements must be met before continuing: 


+ NetWare server version 

+ Directory Services version 

+  CLIB version 

+ HCSS is not loaded (NetWare 4 only) 

¢ SFT™ [IT server is not used (NetWare 4 only) 

+ Unsupported drivers are unloaded (NetWare 4 only) 


If the target server does not meet a critical minimum requirement, the 
server property will be listed in red. NetWare Accelerated Upgrade will 
not allow you to continue until you have met all critical minimum 
requirements. 


IMPORTANT: If prompted to update your NICI file, follow the instructions in Step 
2 on page 14 before continuing. 
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9 Check any of the following options that you want NetWare Accelerated 
Upgrade to automatically perform during the upgrade, and then click the 
right-arrow: 


+ Reboot the target server after the upgrade is completed. 


Even if you checked this option, there might be an instance where 
you might need to manually reboot the target server once the file 
copy is complete. 


+ Update the existing drivers on the target server to NetWare 6 LAN 
and disk drivers. 


Because NetWare Accelerated Upgrade has renamed the 
STARTUP.NCF file to STARTUP.AUP, during auto-detection, 
NetWare Accelerated Upgrade will restore the original 
STARTUP.NCF and then loads the appropriate HAM and .CDM 
drivers that NetWare 6 supports. 


If device drivers are not found for a device currently loaded in the 
former STARTUP.NCF or AUTOEXEC.NCF files, the LOAD line 
will be deleted or copied to the new file and then commented out. 


WARNING: If the target server contains any disk drivers that are not 
compatible with NetWare 6, they cannot be replaced during the hardware 
auto-detection process and your server cannot be upgraded. To avoid this, 
unload any drivers that are not compatible with NetWare 6 before you 
complete the upgrade. NetWare Accelerated Upgrade automatically detects 
unsupported drivers and will warn you about proceeding. 


+ Remove any unsupported DOS utilities existing on the target server 
(NetWare 4 servers only). 


10 Review the list of products that NetWare Accelerated Upgrade is going to 
install and click the right-arrow. 


Once you click the right-arrow, you might need to wait a few minutes 
before the Progress Screen appears. 


11 Monitor the Progress Screen and click Close when the NetWare 6 
Operating System files have been copied to the target server. 


Your target server has now been upgraded to a NetWare 6 server. NetWare 
Accelerated Upgrade does not install additional network products during 
the upgrade. To install additional network products, see “Installing 
Additional Networking Products” on page 20. 


Continue with “Complete Post-Upgrade Tasks.” 
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Complete Post-Upgrade Tasks 


Installing Licensing Certificates 


Because the NetWare Accelerated Upgrade utility does not install licenses, 
use iManage via NetWare Web Manager to install license certificates on the 
new NetWare 6 server. 


NOTE: If licenses are installed at the [Root] of the NDS tree or you are on an MLA 
account, you might not need to install additional licenses. 


1 Go to NetWare Web Manager by entering the following into a Web 
browser: 


https: //nw6serveripaddress: portnumber 
2 Click the ¡Manage icon. 
3 Click License Management > Install Licenses. 


4 Follow the on-screen instructions. 


Installing Additional Networking Products 


NetWare Accelerated Upgrade does not install additional products. If you 
want to add network products, you can do so in one of two ways: 


+ Through the server console by clicking the Novell icon on the servertop 
and then Install. 


¢ Through Deployment Manager (located at the root of the NetWare 6 
Operating System CD). 


Specifying Disk Drivers Manually 


You might want to change the behavior of hardware detection and the NDS 
database upgrade. By replacing the -U option with the -MU option from the 
lines that load HDETECT.NLM in the HWDETECT.ICS script file, you can 
confirm or add new hardware devices during the upgrade. 


To confirm or add new hardware devices during the upgrade, you must 
physically be at the server console of the target server. 


This procedure can also be used to load disk drivers that are not provided on 
the NetWare 6 Operating System CD. This action might be beneficial when 
upgrading multiple servers with identical hardware components. If you select 
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specific drivers manually, you must create and configure a \STARTUP 
directory that contains the disk drivers and the STARTUP.NCF file. 


1 Copy the NetWare 6 Operating System CD files to a volume on a staging 
server. 


IMPORTANT: Do not copy the files onto the target server that you are upgrading 
or onto the client workstation. 


2 Make sure that the target server can connect to the staging server. 


3 Copy any additional HAM and .CDM disk drivers that you need to the 
\STARTUP directory on the staging server. 


4 Continue with “Prepare the Network” on page 17. 


Troubleshooting Server-to-Server Connections 


If you could not make a server-to-server connection during NetWare 
Accelerated Upgrade, try one or more of the possible solutions. 


Disabling SAP Filtering 
1 At the server console of the target server, enter 
INETCFG 


2 Select Protocols > IPX > Filtering Support. 


If SAP filtering cannot be disabled, make sure that the client workstation is on 
the same LAN segment as the target and staging servers. 


Detaching from Unauthenticated Servers 


41 From a Windows 95/98 or Windows NT client, right-click the red 
Novell N. 


2 Click NetWare Connections. 
3 Select the server that you are not authenticated to. 


4 Click Detach. 


If you are still having problems communicating with the target server, reboot 
the client workstation and try to log in to the target server again. 
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Setting the Target Server’s Gate Parameter to Its Default Router IP 
Address 


For a NetWare 4 Target Server 
41 At the server console, enter 
LOAD INSTALL 
2 Select NCF Files Options > Edit AUTOEXEC.NCF File. 
3 In the AUTOEXEC.NCF file, add 
LOAD TCP/IP 


4 Add a command that loads the network board and specifies the slot, 
frame, and name of the network board (the AUTOEXEC.NCF file should 
list this information). 


For example, if you had a NE2000™ network board located in slot 3 with 
an Ethernet_II frame, you would add a command similar to the following: 


LOAD NE2000 Slot=3 Frame=ethernet_II Name=NE2000 


5 Addacommand that will load the network board and its IP address, mask 
address, and gate parameter (set this to the default router IP address of the 
target server). 


For example, for the NE2000 network board with a default router IP 
address of 137.33.172.1, the command would be similar to the following: 


LOAD NE2000 addr=137.65.178.1 mask=255.255.255.0 
gate=137.33.172.1 


6 Add a command to bind IP to the network board, using the following 
format: 


BIND IP network_board_name 
7 Next, add the IP address, mask address, and gate parameter for the target 
server to the BIND IP command line. 
For a NetWare 5 Target Server 
4 At the server console, enter 
NWCONF IG 
2 Select NCF Files Options > Edit AUTOEXEC.NCF File. 
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3 At the BIND IP command line, after the mask address, set the gate 
parameter to the default router IP address for the target server. 


For example, if your default router IP address was 137.65.178.1, at the 
BIND IP command line you would enter the following after the mask 
address: 


gate=137.65.178.1 
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Automating the NetWare Installation 
with a Response File 


Installing the NetWare® operating system software can be easier and more 
flexible when you use a response file. When used with the graphical server 
installation, a response file lets you 


+ Set and display specific defaults 
+ Bypass entire sections of the installation 


+ Automate the entire server installation process 


A response file is a text file containing sections and keys (similar to a 
Windows .INI file). You can create a response file using any ASCII editor. 


If you use a response file, the NetWare server installation reads the installation 
parameters directly from the response file, replacing the default installation 
values with response file values. The installation program accepts the values 
as they appear and continues to the next installation screen. Because the 
installation program gets all the required information from the response file, 
you can even skip the entire sequence of installation screens. 


Using a response file to install NetWare can be very useful to a variety of 
customers and vendors. Novell® customers who have established server 
hardware standards in their enterprise can use the response file to rapidly 
deploy multiple NetWare servers. They will also find the response file useful 
for preconfiguring some of the NetWare installation, while leaving other 
parameters to the local administrator. Resellers and OEMs will find the 
response file useful for pre-installing NetWare prior to shipping a server to 
their customers. 
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This chapter contains the following sections: 


+ 


+ 


+ 


“Creating a Response File” on page 26 

“Using a Response File” on page 27 

“Syntax” on page 28 

“NetWare Sections and Keys” on page 33 

“Performing a Fully Automated Installation” on page 78 


“Automating the Installation of Additional Products and Services” on 
page 79 


“CD Boot and the Response File” on page 87 
“Customizing the Installation Using Install Scripts” on page 87 


“Performing a Factory Install” on page 90 


Creating a Response File 


You can create a new response file, or edit one from a previous server 
installation. 


NOTE: You should take care when using a response file from a previous 
installation because it can contain advanced configuration options you don’t want 
for your current installation. 


Creating a New Response File 


1 


Open an ASCII editor such as EDIT. 


2 Input parameters as described in “Syntax” on page 28. 


Editing a Response File from a Previous Server Installation 
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You can generate a response file from a server installation or upgrade, and then 
use it as input for additional server installations or upgrades. Using the 
response file from another server installation works best when both servers 
have the same hardware configurations. 


1 


2 


Perform the first server installation, and then reboot the server by clicking 


Yes on the closing screen of the installation. 


Log in to the new server after it has been rebooted. 
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3 Copy RESPONSE.NI from the SYS:NI\DATA directory to either a 
diskette or to the new server. 


4 Modify the file by adjusting the parameters and removing unwanted 
sections. 


See “Syntax” on page 28 for a description of the parameters 


Using a Response File 


A response file can be used during a server installation in one of two ways: 
¢ Identified during the server installation 


+ Entered at the command line 


Using a Response File during a Server Installation 


1 Copy the response file to a diskette, hard disk, or network directory 
accessible by the PC that you are installing NetWare on. 


2 Enter INSTALL to start the server installation. 


3 On the Install Options screen (the first screen after the language section), 
press F3 for the response file window. 


4 Enter the path for the response file, and then press Enter. 


5 Continue with the rest of the server installation. 


Entering a Response File at the Command Line 


1 Copy the response file to a diskette, hard disk, or network directory 
accessible by the server that you are installing NetWare on. 


2 Start the server installation from CD, hard disk, or network directory by 
entering 


INSTALL /RF=response_file_DOS_path\ filename 


Replace response file DOS path with the path for the response file, and 
filename with the name of the response file. For example, if you are 
installing NetWare from a CD and the response file is on a diskette, enter 


D:\INSTALL /RF=A:\RESPONSE. TXT 
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Syntax 


A response file is a Windows .INI-type file. Data items are identified as keys, 
and keys have associated values (Key = value). These keys are grouped in 
sections. For the NetWare installation program, each data input screen has one 
or more sections associated with it. Section names of the installation generally 
correspond to the function of the screens. 


Section and key names are case sensitive. Values associated with keys are not 
case sensitive. Semicolons placed at the beginning of a line indicate that the 
line is a comment. 


Sections can be placed in any order. However, if there are two or more sections 
with the same section name, the first section listed in the response file will be 
used and the other sections will be ignored. 


The following sections apply to the NetWare server installation. They are 
listed in the order they are used during installation. 





Section Purpose 





“[NWI:Product Information] Section” Identifies the specific product version the 
on page 33 response file is associated with. 





“[NWI:Language] Section” on page Specifies the languages to be installed on 
34 the server. 





“[NWI:Install Options] Section” on Corresponds to the first data input screen. 
page 35 





“[NWI:Server Settings] Section” on Corresponds to the server settings 
page 37 screen. 





“[NWI:Locale] Section” on page 38 Corresponds to the regional settings 





screen. 
“[NWI:Mouse and Video] Section” Corresponds to the video and mouse 
on page 39 settings screen. 





“[NWI:Hardware] Section” on page Corresponds to the hardware detection 

40 and driver matching function of the 
installation program. If drivers are found in 
the Update directories, they will be used 
instead of the drivers found on the 
NetWare CD. 
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Section 


Purpose 





“[NWI:Excluded From Detection] 
Section” on page 44 


Identifies what drivers will be excluded 
from the auto-detection. 





“[NWI:Multi-Processor System] 
Section” on page 44 


Identifies the driver associated with the 
processor system in the server. 





“[NWI:Storage Adapter n] Section” 
on page 45 


Identifies the driver and its associated 
parameters for a specific storage adapter. 
This Section can be duplicated for as 
many adapters as are in the server. n 
uniquely identifies the sequence of the 
Section (for example, 1, 2, etc.). 





“[NWI:Storage Device n] Section” on 
page 46 


Specifies storage devices. This section 
can be duplicated for as many devices as 
are in the server. n uniquely identifies the 
sequence of the Section (for example, 1, 
2, etc.). 





“[NWI:Network Adapter n] Section” 
on page 47 


Identifies the driver and its associated 
parameters for a specific network adapter. 
This section can be duplicated for as many 
devices as are in the server. n uniquely 
identifies the sequence of the Section (for 
example, 1, 2, etc.). 





“[NWI:Reserved Adapter n] Section” 
on page 50 


Specifies the adapters that are to be 
reserved. 





“[NWI:Hotplug System] Section” on 
page 50 


Identifies the driver associated with the 
processor system in the server. 





“[NWI:NetWare Loadable Module] 
Section” on page 51 


Identifies NLM™ programs that are to be 
loaded with the hardware drivers. 





“[NWI:Misc] Section” on page 59 


Functions as a container of parameters 
that do not correspond to a data input 
screen. 





“[NWI:File System] Section” on page 
51 


Specifies the parameters for the partitions 
and volumes. 





“[NWI:File Server] Section” on page 
60 


Specifies the parameters that uniquely 
identify the server. 
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Section 


“[NWI:Protocols] Section” on page 
61 


Purpose 


Controls whether the protocol screen is 
displayed. 





“[NWI:TCPIP] Section” on page 62 


Specifies TCP/IP parameters. 





“[NWI:IPX] Section” on page 63 


Specifies IPX™ parameters. 





“[NWI:IPCMD] Section” on page 64 


Specifies Compatibility Mode parameters. 





“[NWI:SNMP] Section” on page 65 


Specifies Simple Network Management 
Protocol parameters. 





“[NWI:DNS] Section” on page 67 


Specifies Domain Name Service (DNS) 
parameters. 





“[NWI:Host Name] Section” on page 
68 


Specifies DNS Host Name for each IP 
address. 





“[NWI:Time Zone] Section” on page 
69 


Corresponds to the time zone screen. 





“[NWI:Time Synchronization] 
Section” on page 70 


Specifies time server configuration. 





“[NWI:NDS] Section” on page 70 


Corresponds to the NDS® screen. 





“[NWI:License] Section” on page 74 


Identifies the location of the license file. 





“[NWI:Add to Startup] Section” on 
page 76 


Specifies lines to be added to the 
STARTUP.NCF file. 





“[NWI:Append To Autoexec.ncf] 
Section” on page 77 


Specifies lines to be added to the 
AUTOEXEC.NCF file. 





“[NWI:Use NCF Settings] Section” 
on page 77 


Specifies whether to use the response file 
or the AUTOEXEC.NCF file for the server 
name during an upgrade. 





“[Novell:NOVELL_ROOT:1.0.0] 
Section” on page 78 


Specifies full automation of installation. 





“[Selected Nodes] Section” on page 
80 


Specifies full automation of products and 
services. 





“[LDAP] Section” on page 83 


Specifies full automation of products and 
services. 
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Section 


Purpose 





“[Novell:DNS_DHCP:1.0.0] Section” 


on page 85 


Specifies full automation of products and 
services. 





“[NWI:Install Script] Section” on 
page 88 


Specifies full automation of products and 
services. 





“[NWI:Factory] Section” on page 91 


Specifies full automation of factory install. 





“[Novell:StartupDirectory:1.0.0] 
Section” on page 92 


Specifies full automation of factory install. 





“[Novell:SY SDirectory: 1.0.0] 
Section” on page 92 


Specifies full automation of factory install. 





“[Novell:ConfigDirectory: 1.0.0] 
Section” on page 93 


Specifies full automation of factory install. 





“[Novell:LANFiles: 1.0.0] Section” on 
page 93 


Specifies full automation of factory install. 





“[Novell:SBDFiles:1.0.0] Section” on 
page 94 


Specifies full automation of factory install. 





“[Novell:portalzip:1.0.0] Section” on 
page 94 


Specifies full automation of factory install. 





“[Novell:Rconjzip:1.0.0] Section” on 
page 95 


Specifies full automation of factory install. 





“[Novell:Perl5zip:1.0.0] Section” on 
page 95 


Specifies full automation of factory install. 





“[Novell:beanszip:1.0.0] Section” on 
page 96 


Specifies full automation of factory install. 





“[Novell:scripteszip:1.0.0] Section” 
on page 97 


Specifies full automation of factory install. 





“[Novell:scripteszip:1.0.0] Section” 
on page 97 


Specifies full automation of factory install. 





“[Novell:console1zip:1.0.0] Section” 
on page 97 


Specifies full automation of factory install. 





“[Novell:Idapzip:1.0.0] Section” on 
page 98 


Specifies full automation of factory install. 





“[Novell:wanmanzip:1.0.0] Section” 
on page 98 
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Specifies full automation of factory install. 
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The Prompt key is listed with each section that corresponds to a data input 
screen and it 


+ Controls whether the screen will be displayed. 
+ Lets you use the response file to pass in the keys and values of the section. 


+ Lets you bypass the screen. 


If the value of Prompt is True, the screen will be displayed and the data 
specified in the response file will be presented as default values. The screen 
will not be displayed if the value of Prompt is False. If any of the required data 
is missing in the response file, however, the screen will be shown regardless 
of the Prompt value. For more information on each section’s keys, see 
“NetWare Sections and Keys” on page 33. 


In the following example, the data input screen will be displayed with the NDS 
information already filled in: 


[NWI:NDS] 

Prompt = True 

Tree Name = Novell 

New Tree = True 

Server Context = O=Utah 
Admin Context = O=Utah 
Admin Login Name = Admin 
Admin Password = install 
Display Summary = True 


In the following example, the NDS input screen and the Summary screens will 
not be displayed and the NetWare installation program will bypass them. 


[NWI:NDS] 

Prompt = False 

Tree Name = Novell 

New Tree = True 

Server Context = O=Utah 
Admin Context = O=Utah 
Admin Login Name = Admin 
Admin Password = install 
Display Summary = False 
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NetWare Sections and Keys 


The NetWare installation sections and their associated keys are specified 
below. Section names and Key names are in bold. Included with each key are 
the default value, possible values, whether the Key is required for the Net Ware 
installation to run silently (for example, to create a new NDS tree without any 
user input, New Tree=True must appear in the response file). Also included 
with each Key is a short description of the Key’s purpose. 


[NWI:Product Information] Section 


Major Version = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


NetWare 6 

(product name) 

Yes 

Major Version = NetWare 6 

Specifies the name of the product that this response file is 
associated with. If this value does not match that of the 
NetWare default response file (normally found in the 


INSTALL directory on the CD), the installation will not 
continue. 





Minor Version = <integer> 





Default 

Value 

Key Required 
Example 


Purpose 


Minor Version = 10 


Specifies the revision level of the product. If this value 
does not match that of the NetWare default response file 
(normally found in the INSTALL directory on the CD 
image), the installation will not continue. 


NOTE: The default value was inadvertently left at 0 for 
the English version release. The error was corrected in 
the international release. 
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Small Business = <string> 


Default 

Value 

Key Required 
Example 


Purpose 


[NWI:Language] Section 


Prompt = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Server Language = <integer> 


Default 
Values 

Key Required 
Example 


Purpose 
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False 

True or False 

No 

Small Business = True 


Controls whether the Small Business licensing model is 
used. 


True 

True or False 
Yes 

Prompt = True 


Controls whether the screen is displayed. 


4 (English) 


1-100 


Yes 


Server Language = 4 


Specifies the language that the screens of the installation 
program will be displayed in and that will be the default 
language of the server. 


Additional Languages = <integers separated by commas> 


[NWI:Install Options] Section 


Prompt = <string> 


Upgrade = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Default 
Values 

Key Required 
Example 


Purpose 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

1-100 (values are specified in INSTALL\PROFILE.TXT) 
No 

Additional Languages = 5,6 


Specifies additional languages that will be installed on the 
server. 


True 

True or False 
Yes 

Prompt = True 


Controls whether the screen is displayed. 


False 

True or False 

Yes 

Upgrade = False 

Specifies whether the installation will be an upgrade or a 


new installation. False specifies a new installation rather 
than an upgrade. 
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Startup Directory = <string> 





Default C:\NWSERVER 

Values (existing DOS path up to 255 characters) 

Key Required Yes 

Example Startup Directory = CANWSERVER 

Purpose Identifies the directory where the server’s initialization files 


will reside on the Boot Partition. 





Allow User response file = <string> 





Default True 

Values True or False 

Key Required No 

Example Allow User response file = True 

Purpose Makes the F3 key available on the opening screen. It 


allows a user to input a path to an additional response file. 


NOTE: Values in a user response file will override the 
values of other response files passed in previously to the 
installation program. 





Abort on Error = <string> 





Default False 

Values True or False 

Key Required No 

Example Abort on Error = True 

Purpose Specifies whether the installation will halt when an error is 


encountered during an unattended installation. The user will 
normally see an error screen if this key is set to False. 
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[NWI:Server Settings] Section 


Prompt = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


NDS Version = <integer> 


Default 
Values 

Key Required 
Example 


Purpose 


True 

True or False 
Yes 

Prompt = True 


Controls whether the screen is displayed. 


NDS Version = 8 


Specifies the version of NDS to install on this server. 





Load Server at Reboot = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


True 

True or False 

No 

Load Server at Reboot = True 


Adds new AUTOEXEC.BAT and CONFIG.SYS files that sets 
a minimal DOS environment and automatically loads the 
server. Pre-existing AUTOEXEC.BAT and CONFIG.SYS 
files on the server will be renamed to *.000. If this value is set 
to True and AUTOEXEC.000 already exists, then 
AUTOEXEC.BAT will be renamed to AUTOEXEC.001, etc. 
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CD Driver = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


[NWI:Locale] Section 


Prompt = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Country Code = <integer> 


Default 


Values 


Key Required 
Example 


Purpose 
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NetWare 

NetWare or DOS 

No 

Source Media Access = NetWare 


Determines the driver type (DOS or server) used to access 
the CD during installation. 


True 

True or False 
Yes 

Prompt = True 


Controls whether the screen is displayed. 


001 


(Values are specified in INSTALLINLSVanguage 
numbenLOCALE.TXT) 


Yes 
Country Code = 001 


Specifies the country-oriented settings for display. 





Code Page = <integer> 


Default 


Values 


Key Required 
Example 


Purpose 


Keyboard = <string> 


Default 


Values 


Key Required 
Example 


Purpose 


437 


(values are specified in INSTALLINLSVanguage 
numbenLOCALE.TXT) 


Yes 
Code Page = 437 


Sets the character set for the server. 


United States 


(values are specified in INSTALL\NLS\</anguage 
number>\LOCALE.TXT) 


Yes 
Keyboard = United States 


Sets the keyboard type. 


[NWI:Mouse and Video] Section 


Prompt = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


True 

True or False 
Yes 

Prompt = True 


Controls whether the screen is displayed. 
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Mouse = <string> 


Default PS/2 

Values PS/2, Serial COM1, Serial COM2, No Mouse (values are 
specified in INSTALLINLSVanguage numbenLOCALE.TXT) 

Key Required Yes 

Example Mouse = PS/2 

Purpose Specifies the mouse type that will be used for the graphical 


portion of the installation. 





Use Super VGA = <string> 





Default True 

Values True or False 

Key Required No 

Example Use Super VGA = True 

Purpose Indicates whether 256-color Super VGA is set for the 


graphical portion of the installation. If set to False, 16-color 
Standard VGA is set. 


[NWI:Hardware] Section 


Prompt = <string> 





Default True 

Values True or False 
Key Required Yes 

Example Prompt = True 


Purpose Controls whether the screen is displayed. 
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Update Storage Driver Directory = <DOS path> 


Default 


Values 
Key Required 
Example 


Purpose 


(none) 

The Install always looks in C:\NWUPDATE as well. 

(existing DOS path up to 255 characters) 

No 

Update Storage Driver Directory = F:\DRV\UPDATE 
Specifies the directory path where updated storage (HAM and 
CDM) drivers will be found; the directory should already exist 


and be a local DOS path. 


NOTE: Associated DDI files must accompany the storage 
drivers in this directory. 


Update Network Driver Directory = <DOS path> 


Default 


Values 
Key Required 
Example 


Purpose 


(none) 

The Install always looks in CANWUPDATE as well. 
(existing DOS path up to 255 characters) 

No 

Update Network Driver Directory = F:\DRV\UPDATE 


Specifies the directory path where updated network (LAN) 
drivers will be found; the directory should already exist and be 
a local DOS path. 


NOTE: Associated LDI files must accompany the storage 
drivers in this directory. 
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Update PSM Driver Directory = <DOS path> 


Default 


Values 
Key Required 
Example 


Purpose 





(none) 

The Install always looks in C:\NWUPDATE as well 

(existing DOS path up to 255 characters) 

No 

Update PSM Driver Directory = F:\DRV\UPDATE 

Specifies the directory path where updated processor (PSM) 
drivers will be found; the directory should already exist and be 


a local DOS path. 


NOTE: Associated PDI files must accompany the storage 
drivers in this directory. 


Update Source Drive Type = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





PSM Detection = <string> 





Default 
Values 

Key Required 
Example 


Purpose 
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(the type of the install source) 

Floppy or CD or Network or Other 

No, unless one or more of the Update keys above are set. 
Update Source Drive Type = Network 


Specifies the type of all source directories identified in the keys 
above; all directories must be of the same type. 


True 

True or False 

No 

PSM Detection = True 

Controls whether driver matching is performed for the processor 


system. If driver information is identified in the response file (see 
Multi-Processor System section), detection can be set to False. 


Storage Detection = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





Network Detection = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





Device Detection = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





True 

True or False 

No 

Storage Detection = True 

Controls whether detection of storage adapters and driver 
matching is performed. If storage adapter and driver information 


is identified in the response file (see Storage Adapter section), 
detection can be set to False. 


True 

True or False 

No 

Network Detection = True 

Controls whether detection of network adapters and driver 
matching is performed. If network adapter and driver 


information is identified in the response file (see Network 
Adapter section), detection can be set to False. 


True 

True or False 

No 

Device Detection = True 

Controls whether detection of storage devices and driver 
matching is performed. If storage adapter and driver information 


is identified in the response file (see Storage Device section), 
detection can be set to False. 
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HotPlug Detection = <string> 


Default True 

Values True or False 

Key Required No 

Example HotPlug Detection = True 


Purpose Controls whether detection of Hot Plug devices and driver 
matching is performed. 


[NWI:Excluded From Detection] Section 


Driver File = <filename> 


Default (none) 

Values (name of driver) 

Key Required No 

Example Driver File =AHA2940.HAM 

Purpose Identifies the driver that will be excluded from auto-detection. 


[NWI:Multi-Processor System] Section 


Driver File = <filename> 





Default (none) 

Values (name of driver) 

Key Required No, unless PSM Detection=False 

Example Driver File = MPS14.PSM 

Purpose Identifies the driver to use for the server's multiprocessor 
system. 
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[NWI:Storage Adapter n] Section 


Example 


Description 





Driver File = <filename> 


Default 
Values 

Key Required 
Example 


Purpose 


SLOT = <integer> 





Default 


Values 


Key Required 
Example 


Purpose 


[NWI:Storage Adapter 1] 

This section can be included for each storage adapter in the 
server. Several Keys are described under this section which 
are optional; if the driver is detectable by NetWare, only the 
Driver File key is required for the section. The other Keys and 


Values are varied and are extracted from the driver’s 
corresponding DDI file. 


(none) 

(name of driver) 

No, unless Storage Detection=False 
Driver File = AHA2940.HAM 


Identifies the driver to use for the storage adapter. 


(none) 


(can be a 5-digit Hardware Instance Number assigned on 
servers with buses that support detection—such as PCI) 


No, unless the driver is for an ISA adapter 
SLOT =2 


Specifies the bus slot of the storage adapter to which the 
driver should be loaded. 
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INT = <hexadecimal number> 


Default (none) 

Values 1-F 

Key Required No, unless the driver is for an ISA adapter. 
Example INT =F 

Purpose Specifies the interrupt that the adapter is set to; this 


parameter is commonly used for ISA bus adapters. 


PORT = <number> 


Default (none) 

Values (3-digit memory address) 

Key Required No, unless the driver is for an ISA adapter 

Example PORT = 170 

Purpose Specifies the memory address the adapter is set to; this 


parameter is commonly used for ISA bus adapters. 





[NWI:Storage Device n] Section 


Example [NWI:Storage Device 1] 
Description This section can be included for each storage device in the 
server. 


Driver File = <filename> 


Default (none) 

Values (name of driver) 

Key Required No, unless Device Detection=False 

Example Driver File = IDECD.CDM 

Purpose Identifies the driver to use for the storage device. 
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[NWI:Network Adapter n] Section 


Example 


Description 


[NWI:Network Adapter 1] 


This section can be included for each network adapter in 
the server. Several Keys are described under this section 
which are optional; if the driver is detectable by NetWare, 
only the Driver File Key is required for the section. The 
other Keys and Values are varied and are extracted from 
the driver's corresponding LDI file. 





Driver File = <filename> 


Default 
Values 

Key Required 
Example 


Purpose 


SLOT = <integer> 


(none) 

(name of driver) 

No, unless Network Detection=False 
Driver File = 3C59X.LAN 


Identifies the driver to use for the network adapter. 





Default 


Values 


Key Required 
Example 


Purpose 


(none) 


(can be a 5-digit Hardware Instance Number assigned on 
servers with buses that support detection—such as PCI) 


No, unless the driver is for an ISA adapter 
SLOT = 10001 


Specifies the bus slot of the network adapter to which the 
driver should be loaded. 
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INT = <hexadecimal number> 


Default (none) 

Values 1-F 

Key Required No, unless the driver is for an ISA adapter 
Example INT =F 

Purpose Specifies the interrupt that the adapter is set to; this 


parameter is commonly used for ISA bus adapters. 


PORT = <number> 


Default (none) 

Values (3-digit memory address) 

Key Required No, unless the driver is for an ISA adapter 

Example PORT = 170 

Purpose Specifies the memory address the adapter is set to; this 


parameter is commonly used for ISA bus adapters. 





Adapter Name = <string> 





Default (none) 

Values (text up to 255 characters) 

Key Required No 

Example Adapter Name = 3C59X_1 

Purpose Specifies a unique name for this adapter. 
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Frame Type n = <frame type> 


Default 


Values 


Key Required 
Example 


Purpose 


Logical Name n = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


Octet Bit Order = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





(none) 


(frame types supported by the driver are found in the 
driver’s LDI file) 


No 

Frame Type 1 = Ethernet_802.2 

Identifies the network frame type to be used when loading 
the driver. There can be as many descriptions as there 


are frame types supported by the driver—n uniquely 
identifies the frame type (for example, 1, 2, etc.). 


(none) 

(text combining the Frame Type with the Adapter Name) 
No 

Logical Name 1 = 3C59X_1_E82 

Identifies the name to be used when binding a protocol to 
a frame type on this adapter. There must be a logical 
name for each frame type loaded with the driver—n 


uniquely identifies the frame type (for example, 1, 2, 
etc.). 


LSB 

LSB or MSB 

No 

Octet Bit Order = LSB 

Specifies the bit order (Least Significant Bit or Most 


Significant Bit) that this network adapter uses for 
deciphering the node address. 
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[NWI:Reserved Adapter n] Section 








Example [NWI:Reserved Adapter 1] 

Description This section can be included for each slot in the server. 
SLOT = <integer> 

Default (none) 

Values (can be a 5-digit Hardware Instance Number assigned on 


servers with buses that support detection—such as PCI) 


Key Required No, unless the driver is for an ISA adapter 
Example SLOT = 5 
Purpose Specifies the bus slot that should be reserved. If an adapter 


is found in this slot, an error is generated. 





[NWI:Hotplug System] Section 


Driver File = <filename> 





Default (none) 

Values (name of driver) 

Key Required No, unless HotPlug Detection=False 

Example Driver File = CPQSBD.NLM 

Purpose Identifies the driver to use for the Hot Plug system. 
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[NWI:NetWare Loadable Module] Section 


Driver File = <filename> 





Default (none) 

Values (name of NLM) 

Key Required No 

Example Driver File = ROUTE.NLM 

Purpose Identifies the NLM to load during installation. This is 


typically used for network support NLM programs. 


[NWI:File System] Section 


Prompt = <string> 


Default True 

Values True or False 

Key Required Yes 

Example Prompt = True 

Purpose Controls whether the character-based SYS Volume and 


Partition screen is displayed. 





Allow Volume Properties = <string> 


Default True 

Values True or False 

Key Required No 

Example Allow Volume Properties = True 

Purpose Controls whether the F3 Volume Properties option is 


displayed. 
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GUI Prompt = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


[NWI:Partition n] Section 


Example 


Description 





Device Type = <string> 





Default 
Values 

Key Required 
Example 


Purpose 
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True 

True or False 

Yes 

GUI Prompt = True 


Controls whether the File System screen is displayed during 
the graphical portion of the install. 


[NWI:Partition 0] 


This section allows partitions to be created on specific 
devices in the system during installation. The devices are 
specified by the key entries in the section. The zero-based 
sequence number (n = 0, 1, 2, 3, ...) in the section heading 
specifies the order in which the partitions are created. The 
partition on which volume SYS is created must be defined in 
[NWI:Partition 0]. 


(none) 

IDE or SCSI 

No 

Device Type = IDE 


Identifies the type of the device the partition is to be placed 
on. 


IDE Device Serial Number = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





IDE Device Channel = <integer> 


Default 
Values 

Key Required 
Example 


Purpose 


IDE Device Type = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(string of characters) 

No 

IDE Device Serial Number = AX8273430930. 

Specifies the serial number of the device designated by the 


manufacturer. (It is usually found on a sticker attached to the 
device.) 


(none) 

1or2or3or4 

No 

IDE Device Channel = 1 


Identifies the channel on which the device is to be found. 


(none) 

Master or Slave 

No 

IDE Device Type = Master 


Specifies the IDE type of the device on the channel. 
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SCSI Device Adapter Slot = <integer> 


Default 
Values 

Key Required 
Example 


Purpose 


SCSI Device ID = <integer> 


Default 
Values 

Key Required 
Example 


Purpose 


Partition Type = <string> 


Default 
Values 

Key Required 
Example 


Purpose 
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(none) 

1 to16 

No 

SCSI Device Adapter Slot = 1 


Identifies the physical slot number of the SCSI adapter 


(none) 

0 to 15 

Yes 

SCSI Device ID = 0 


Specifies the ID of the device on the SCSI chain 


NSS 

NetWare or NSS or Free 
No 

Partition Type = NSS 


Identifies the type of partition to be created 





Partition Size = <integer> or <ALL FREE SPACE> 


Default 
Values 

Key Required 
Example 


Purpose 





Partition HotFix Size = <integer> 





Default 
Values 

Key Required 
Example 


Purpose 


Mirror Partition = <integer> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(up to the size of free space on the device in MB) 

No 

Partition Size = 1000 

Identifies the size of the partition. Note that the number is 
modified to align with a cylinder boundary. "ALL FREE 


SPACE" specifies that all remaining free space on the 
device will be used. 


(calculated on Partition Size) 
0 to 120 (in MB) 

No 

Partition HotFix Size = 20 


Identifies the size of the redirection area on the partition 


(none) 


(partition number) 


Mirror Partition = 3 


Identifies the partition that this partition will be mirrored to. 
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[NWI:Volume n] Section 


Example 


Description 


Volume Name = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


Volume Type = <string> 


Default 
Values 

Key Required 
Example 


Purpose 
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[NWI:Volume 0] 

This section can be included for each volume defined on the 
server. Note that SYS must be Volume 0. This section allows 
volumes to be created on specific partitions in the system 
during installation. The partitions are specified by the key 
entries in the section. The zero-based sequence number (n 
= 0, 1, 2, 3, ...) in the section heading specifies the order in 


which the volumes are created. Volume SYS must be 
defined in [NWI:Volume 0]. 


(none) 

(valid volume name) 
Yes 

Volume Name = DATA 


Identifies the name of the volume; follows naming 
convention found in the NetWare user documentation. 


NSS 

NetWare or NSS or Free 

No 

Volume Type = NSS 

Specifies the type of the volume to be created. Note that 


volume types must be created on like partition types (e.g., 
NSS volume on NSS partition). 


Block Size = <integer> 


Default (calculated on the size of the first segment of the volume) 
Values 4 or 8 or 16 or 32 or 64 

Key Required No 

Example Block Size = 64 

Purpose Identifies the volume’s block size. Note that this key does 


not apply to NSS volumes. 


Compression = <string> 


Default True 

Values True or False 

Key Required No 

Example Compression = True 

Purpose Specifies whether compression is enabled on the 
volume. 


Suballocation = <string> 





Default True (on NetWare volume types) 

Values True or False 

Key Required No 

Example Suballocation = True 

Purpose Specifies whether suballocation is enabled on the volume. 


Note that this key does not apply to NSS volumes. 


Automating the NetWare Installation with a Response File 57 


Data Migration = <string> 





Default False 

Values True or False 

Key Required No 

Example Data Migration = True 

Purpose Specifies whether data migration is enabled on the volume. 


Note that this key does not apply to NSS volumes. 





Mount = <string> 





Default False 

Values True or False 

Key Required No 

Example Mount = True 

Purpose Specifies whether the volume should be mounted during 


installation. This is useful if additional products and services 
are to be installed on a volume other than SYS. Note that 
mounting volumes will take additional time during the server 
installation. Also, this key will be ignored if GUI Prompt = 
False is not set in the NWI:File System section; this is to 
avoid a conflict between this key and the mount volumes 
screen during installation. 





Segment n Partition = <integer> 





Default (none) 

Values (any value n previously defined in section [NWI:Partition 
n]) 

Key Required Yes 

Example Segment 1 Partition = 1 

Purpose Identifies the partition on which the volume segment is to 


be created. The number of segments n is limited from 1 to 
8 for NetWare partitions and must be defined sequentially. 
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Segment n Size = <integer> or <ALL FREE SPACE> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(up to free space on a partition in MB) 

Yes 

Segment 1 Size = 1000 

Specifies the size of the volume segment. "ALL FREE 


SPACE" specifies that all remaining free space on the 
partition will be used. 





[NWI:Misc] Section 


Relogin Password = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(text) 

No, unless it is a network installation. 
Relogin Password = Novell 


Specifies the password for the user connection being 
used while installing across the network. When this 
section is properly used, the install bypasses the 
reauthentication screen following the loading of the LAN 
driver and prior to the preliminary file copy. 
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[NWI:File Server] Section 


NOTE: This is the first section used during the graphical portion of the installation. 


Prompt = <string> 





Default True 

Values True or False 

Key Required Yes 

Example Prompt = True 

Purpose Controls whether the screen is displayed. 


Servername = <string> 


Default (none) 


Values (text up to 47 characters—see NetWare documentation for 
valid set of characters) 


Key Required Yes 

Example Servername = Novell 

Purpose Specifies the name of the server. Note that a server is 
brought up with temporary name until a valid Servername is 
entered. 


Server ID Number = <hexadecimal number> 





Default (randomly generated) 

Values 00000001-FFFFFFFF 

Key Required Yes 

Example Server ID Number = 01010101 

Purpose Uniquely identifies the server for network communication 


purposes. Note that this number should not conflict with 
any existing IPX™ addresses on your network. 
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[NWI:Protocols] Section 


Prompt = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


Single Network Adapter=<string> 


Default 
Values 

Key Required 
Example 


Purpose 





Default IP Frame Typer=<string> 


Default 


Values 


Key Required 
Example 


Purpose 


True 

True or False 
Yes 

Prompt = True 


Controls whether the protocols screen is displayed. 


False 

True or False 

No 

Single Network Adapter=True 


If this key is set to True then in the [NWI:TCPIP] and 
[NWI:IPX] sections of the response file the "Logical Name 
1" key is automatically filled in with the logical name of the 
first network card found in the system. The logical name 
will be bound to the TCPIP and IPX addresses specified 
in the [NWI:TCPIP] and [NWI:IPX] sections of the 
response file. 


(none) 


(Frame types that are supported by a driver are found in the 
driver’s LDI file 


No 
Default IP Frame Type=Ethernet II 


Identifies the network frame type to be bound to the IP stack 
when the "Single Network Adapter" is set to True. 
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Default IPX Frame Typer=<string> 


Default 


Values 


Key Required 
Example 


Purpose 





[NWI:TCPIP] Section 
Logical Name n = <string> 


Default 


Values 


Key Required 
Example 


Purpose 





IP Address n = <decimal number> 





Default 
Values 

Key Required 
Example 


Purpose 
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(none) 


(Frame types that are supported by a driver are found in the 
driver’s LDI file 


No 
Default IPX Frame Type=Ethernet 802.2 


Identifies the network frame type to be bound to the IPX stack 
when the "Single Network Adapter" is set to True. 


(none) 


(name identified in the Network Adapter sections of the 
response file) 


No, unless IP is to be bound. 
Logical Name 1 = 3C59X_1_ Ell 


Identifies the name of the adapter and frame type that the 
protocol is to be bound to. 


(none) 

(valid IP address) 

No, unless Logical Name is set 
IP Address 1 = 130.1.130.1 


Specifies the IP address to be bound. 


Subnet Mask n = <decimal number> 


Default 
Values 

Key Required 
Example 


Purpose 


Gateway n = <decimal number> 


Default 
Values 


Key Required 


Purpose 


[NWI:IPX] Section 


Logical Name n = <string> 


Default 


Values 


Key Required 
Example 


Purpose 
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(none) 

(valid IP address) 

No, unless Logical Name is set. 
Subnet Mask 1 = 255.255.255.0 


Specifies the subnet. Divides the IP address into network 
address and node address. 


(none) 

(valid IP address) 

No 

Gateway 1 = 127.127.0.254 


Identifies the gateway or router through which this server 
can communicate outside the subnet. 


(none) 


(name identified in the Network Adapter sections of the 
response file) 


No, unless IPX is to be bound 
Logical Name 1 = 3C59X_1_E82 


Identifies the name of the adapter and frame type that the 
protocol is to be bound to. 
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IPX Address n = <hexadecimal number> 


Default (address detected by the installation program) 
Values 00000001-FFFFFFFF 

Key Required No, unless Logical Name is set 

Example IPX Address 1 = 01010102 

Purpose Specifies the IPX address to be bound. 


[NWI:IPCMD] Section 


IPX Compatibility = <string> 





Default True 

Values True or False 

Key Required No 

Example IPX Compatibility = True 

Purpose Controls whether SCMD is loaded on this server. 


Migration Agent = <string> 


Default True 

Values True or False 

Key Required No 

Example Migration Agent = True 

Purpose Controls whether the Migration Agent (SCMD /MA) is loaded 


on this server. 
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CMD Net Number = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

00000001-FFFFFFFF 

No 

CMD Net Number = 01010101 


Specifies the network number. 


Preferred IP Address = <decimal number> 


Default 
Values 

Key Required 
Example 


Purpose 





[NWI:SNMP] Section 


Hardware = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





(none) 

(valid IP address) 

No 

Preferred IP Address = 130.1.130.1 


Specifies the IP address. 


(none) 

Values (text) 

No 

Hardware = Personal Computer 


Identification information that is sent with SNMP traps to 
assist in troubleshooting. 
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Location = <string> 


Default (none) 

Values (text) 

Key Required No 

Example Location = Building A 

Purpose Identification information that is sent with SNMP traps to 


assist in troubleshooting. 


Contact = <string> 


Default (none) 

Values (text) 

Key Required No 

Example Contact = John Doe 

Purpose Identification information that is sent with SNMP traps to 


assist in troubleshooting. 





Trap Targets TCPIP = <decimal numbers separated by commas> 





Default (none) 

Values (valid IP addresses) 

Key Required No 

Example Trap Targets TCPIP = 127.1.127.3 

Purpose Identifies IP address of a computer to which SNMP traps 
are sent. 
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Trap Targets IPX = <MAC address separated by commas> 


Default 
Values 

Key Required 
Example 


Purpose 


[NWI:DNS] Section 


Prompt = <string> 


Domain = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(8-character IPX address: 12-character node number) 
No 

Trap Targets IPX = C9990111:000001B555555 


Identifies MAC addresses of a computer to which SNMP 
traps are sent. 


True 

True or False 
Yes 

Prompt = True 


Controls whether the DNS screen is displayed. 


(none) 

(text) 

No 

Domain = novell.com 


Specify a domain. 
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Nameservers = <decimal numbers separated by commas> 


Default (none) 

Values (valid IP addresses) 

Key Required No 

Example Nameservers = 131.1.131.1, 131.1.131.2 

Purpose Identifies the servers to be used for name resolution. 


[NWI:Host Name] Section 


Prompt = <string> 





Default True 

Values True or False 

Key Required Yes 

Example Prompt = True 

Purpose Controls whether the screen is displayed. 


Host Name n = <string> 


Default (none) 

Values (text) 

Key Required No 

Example Host Name 1 = install.novell.com 

Purpose Specifies the host name associated with an IP address 


already bound. 
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IP Address n = <decimal number> 


Default 
Values 

Key Required 
Example 


Purpose 


[NWI:Time Zone] Section 


Prompt = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Time Zone = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(valid IP address) 

No 

IP Address 1 = 130.1.130.1 


Specifies the IP address associated with a Host Name. 
Note that Host Name 1 will be set as the Primary address. 


True 

True or False 
Yes 

Prompt = True 


Controls whether the time zone screen is displayed. 


(none) 

(string—see COMOTHR.ILS) 

Yes 

Time Zone = (GMT-06:00) U.S. and Canada Central Time 


Specifies the standard time zone. Note that the exact string 
from COMOTHR.ILS (in INSTALL\NLS\4) must be used. 
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Use Daylight Saving Time = <string> 


Default True, if Time Zone supports Daylight Saving Time 
Values True or False 

Key Required No 

Example Use Daylight Saving Time = True 

Purpose Controls whether daylight saving time is set. 


[NWI:Time Synchronization] Section 


Default Time Server Type = <string> 





Default (Single if new tree, Secondary if existing tree) 
Values Single, Primary, Secondary 

Key Required No 

Example Default Time Server Type = Single 

Purpose Specifies the time server type. 


[NWI:NDS] Section 


Prompt = <string> 





Default True 

Values True or False 

Key Required Yes 

Example Prompt = True 

Purpose Controls whether the NDS screen is displayed. 
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Tree Name = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





New Tree = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





Server Context = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





(none) 

(text) 

Yes 

Tree Name = Novell 


Specifies the tree name for either a new tree or an existing 
tree to install the server into. 


False 

True or False 
Yes 

New Tree = True 


Specifies whether the NDS tree to be installed is a new tree 
or install into an existing tree. 


NOTE: This key is only used when Prompt = False. 


(none) 

(NDS distinguished name) 
Yes 

Server Context = .install.novell 


Identifies the NDS context that the server is to be installed 
into. 
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Add Replica = <string> 


Default (none) 

Values True or False 

Key Required No 

Example Add Replica = True 

Purpose Controls whether a replica is added to the server. This only 


applies if the server is not one of the first three servers 
added to an NDS tree (by default the first three servers 
receive replicas). 





Upgrade User Conflict Action = <string> 


Default (none) 

Values Delete, Merge, or Rename 

Key Required No, unless it is an upgrade from NetWare 3.1x 

Example Upgrade User Conflict Action = Merge 

Purpose Determines what action is to be taken during the upgrade of 


a NetWare 3.1x server when objects of the same name are 
found during the conversion of the bindery to NDS. 


Admin Login Name = <string> 


Default (none) 

Values (text) 

Key Required Yes 

Example Admin Login Name = Admin 

Purpose Specifies the name for the server administrator. 
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Admin Context = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Admin Password = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Admin Language = <integer> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(NDS distinguished name) 
Yes 

Admin Context = .install.novell 


Identifies the NDS context in which the server administrator 
is to be installed into. 


(none) 

(text) 

Yes 

Admin Password = Novell 

Specifies the password for the server administrator. Note 


that for security purposes, this password is removed from 
the response file after NDS is installed. 


4 (English) 

1-100 

Yes 

Admin Language = 4 

Specifies the language of the server administrator. User 


objects created by the server administrator will be assigned 
this language. 
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Display Summary = <string> 


Default True 

Values True or False 

Key Required Yes 

Example Display Summary = True 


Purpose Controls whether the NDS Summary screen is displayed 


[NWI:License] Section 


Prompt = <string> 





Default True 

Values True or False 

Key Required Yes 

Example Prompt = True 

Purpose Controls whether the license screen is displayed. 


Display License Agreement = <string> 


Default True 

Values True or False 

Key Required Yes 

Example Display License Agreement = False 

Purpose Controls whether the license agreement screen at the 


beginning of the server install is displayed 
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Install Licenses Later = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





License File = <string> 


Default 


Values 


Key Required 
Example 


Purpose 


NICI Foundation Key File = <string> 


Default 


Values 


Key Required 
Example 


Purpose 


False 

True or False 

No 

Install Licenses Later = True 

Specifies that no licenses will be installed on the server. If 


this key is set to True, all remaining licensing keys will be 
ignored. 


(none) 


(existing DOS path and envelope file name—up to 255 
characters) 


No, unless a license is to be installed 
License File = C:\NWSERVER\0000001.NLF 


Identifies the directory and filename of a license envelope 
file. 


(none) 


(existing DOS path and envelope file name—up to 255 
characters) 


No 
NICI Foundation Key File = C:\LIC\92942492.NFK 


Identifies the directory and filename of a region specific 
cryptography module. 
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Search For Existing License = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





Auto Skip If License Found = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


[NWI:Add to Startup] Section 


Prepend Line n = <decimal number> 





Default 
Values 

Key Required 
Example 


Purpose 
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True 

True or False 

Yes 

Search For Existing License = False 

Controls whether the licenses (such as MLA licenses) are 


searched for in the tree. Used in conjunction with the next 
key. 


False 

True or False 

Yes 

Auto Skip If License Found = True 

Controls whether the license that was found using the 


previous key is used; this is particularly useful for MLA 
accounts. 


(none) 

(decimal number) 

No 

Prepend Line 1 = SET IGNORE DISK GEOMETRY=ON 


Adds the line to the beginning of the STARTUP.NCF file. If 
multiple lines are listed, n should increment sequentially. 


Append Line n = <decimal number> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(decimal number) 

No 

Append Line 1 = LOAD NFS.NAM 


Adds the line to the end of the STARTUP.NCF file. If 
multiple lines are listed, n should increment sequentially. 


[NWI:Append To Autoexec.ncf] Section 


Line n = <decimal number> 


Default 
Values 

Key Required 
Example 


Purpose 





(none) 

(decimal number) 

No 

Line 1 = LOAD MONITOR 


Adds the line to the end of the AUTOEXEC.NCF file. If 
multiple lines are listed, n should increment sequentially. 


[NWI:Use NCF Settings] Section 


Override NCF = <True or False> 


Default 
Values 

Key Required 
Example 


Purpose 


(False) 

(True or False) 

No 

Override NCF = True 

During an upgrade, if set to True, the server name is 


specified in the response file instead of the 
AUTOEXEC.NCF file. 
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Performing a Fully Automated Installation 


The following parameters must be present to completely automate an 

installation or upgrade. The syntax and values for the supplementary NetWare 
installation sections and their associated keys are specified below. For a fully 
automated installation to work, these sections must appear in the response file 
in addition to all of the required keys listed in “NetWare Sections and Keys” 


on page 33. 


[Novell:NOVELL_ROOT:1.0.0] Section 


closeScreen = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Reboot = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

SilentCloseScreen 

Yes 

closeScreen = SilentCloseScreen 


When this parameter is set, the final installation screen is 
not shown. 


(none) 

True or False 
Yes 

Reboot = False 


Controls whether the server is restarted after the final 
screen of the installation is closed. 
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allowSummary = <string> 


silent = <string> 


Default True 

Values True or False 

Key Required Yes 

Example allowSummary = False 

Purpose Controls whether the installation Summary screen is 
displayed. 

Default False 

Values True or False 

Key Required Yes 

Example silent = False 

Purpose Global key that controls whether the installation runs in 


silent mode with no user interaction. Some sections do 
not support this key. If this is the case, use a 
"prompt=false" key instead. 


Automating the Installation of Additional Products and 


Services 


As part of the overall NetWare installation, you can auto-install additional 
products and services by including a [Selected Nodes] section in the response 
file. Because this section of the response file is not as easy to configure as the 
other sections are, we recommended the following: 


1 Perform a manual installation, selecting the products you want to have 
installed on the server. 


2 Modify the resulting response file for use as input to future NetWare 
installations. 


3 Add a [Selected Nodes] section to the input response file. 
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4 Add the following lines under the [Selected Nodes] section heading: 


Novell:NetWare5:1.0.0=Novell:NetWare50S:5.0.0,Novell:Products:1.0.0,Novell:NW 
UpdateGroup:1.0.0 
Novell:NetWare50S8:5.0.0=Novell:DiskCarver:1.0.0,Novell:Protocols:1.0.0,Novell 
:DS_Instal1:1.0.0, Novell: LicensePrompt:1.0.0,Novell:NW:1.0.0,Novell:NDPS 
Server Files:1.0.0 
Novell:NW:1.0.0=Novell:Startup:1.0.0,Novell:SYS:1.0.0,Novell:DriverFiles:1.0. 
0 
Novell: Startup:1.0.0=Novell:StartupDirectory:1.0.0 

Novell: SYS:1.0.0=Novell:SYSDirectory:1.0.0,Novell:ETCDirectory:1.0.0,Novell1:P 
ROFINST_NODE:1.0.0 
Novell:DriverFiles:1.0.0=Novell:LANFiles:1.0.0,Novell:SBDFiles:1.0.0 
Novell:NDPS Server Files:1.0.0=Novell:NDPS System:1.0.0,Novell:NDPS 
Public:1.0.0 

Novell:Products:1.0.0=Novell:NICIInstal1:1.0.0 
Novell:NICIInstal1l:1.0.0=Novell:NICIModule:1.0.0 

Novell :NWUpdateGroup:1.0.0=Novell:NWUpdate:1.0.0 




















NOTE: You can add more lines according to your needs, but these represent the 
minimum information that must be included in the [Selected Nodes] section. 


[Selected Nodes] Section 


Prompt = <string> 





Default True 

Values True or False 

Key Required Yes 

Example Prompt = True 

Purpose Controls whether the Additional Products and Services 


screen is displayed. 
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Product Selection = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

Default or Web 

No 

Product Selection = Web 


Specifies which bundle of Additional Products and Services 
to install. Default will install the Web Services bundle. Web 
will install the Web Services bundle plus WebSphere* 
Application Server. To specify a custom bundle of 
Additional Products and Services, do not include this key, 
and specify each product as described below. 


Novell:Products:1.0.0 = <strings separated by commas> 


Default 


Values 


Key Required 


Example 


Purpose 


Novell:NICIInstall:1.0.0 
NOTE: This NICI install string must be included. 


Novell: NDPS:2.0.0 
Novell:lpLdapService:3.0.0 
Novell:|pCatalogService: 1.0.0 
Novell:|pWanmanService:1.0.0 
Novell:SecuritySASInstall: 1.0.0 
Novell:PKIInstall:1.0.0 
Novell:NICIInstall:1.0.0 
Novell:RAS:4.1.0 
Novell:SMS:1.0.0 
Novell:DNS_DHCP:1.0.0 


Yes 


Novell:Products:1.0.0=Novell:NIClInstall: 1.0.0, Novell: NDP 
S:2.0.0 


Specifies the additional products and services to be 
installed on the server. 
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Installing Multiple Products on a Server 


To install multiple products on a server, make sure that the 
Novell:Products:1.0.0 key has multiple values, separated by commas as 
shown in the example above. 


Product Keys and Values 


In addition to identifying the product in the Novell:Products:1.0.0 key, each 
product has its own keys and values for the [Selected Nodes] section. These 
keys and values for each product are listed below. We recommended that you 
reuse aresponse file from a previous installation rather than attempting to type 
these keys and values into the file. If you do not enter them exactly as shown, 
the NetWare Installation will fail abruptly with no information to help you 
troubleshoot the problem. 


Novell Distributed Print Services (NDPS) 


Novell:NDPS:2.0.0=Novell:NDPS Server Files:1.0.0,Novell:NDPS Resource 
Files:1.0.0 

Novell:NDPS Resource Files:1.0.0=Novell:NDPS Banner:1.0.0,Novell:NDPS 
Font:1.0.0,Novell:NDPS Prndef:1.0.0,Novell:NDPS Prndrv:1.0.0 

Novell:NDPS Prndrv:1.0.0=Novell:NDPS Prndrv W31:1.0.0,Novell:NDPS Prndrv 
W95:1.0.0,Novell:NDPS Prndrv NT4:1.0.0 


LDAP Services 


Novell:SecuritySASModule:1.0.0=Novell:SASFiles:1.0.0 
Novell:PKIModule:1.0.0=Novell:PKIFiles:1.0.0 


NDS Catalog Services 


Novell: IpCatalogService:1.0.0=Novell:DfgCatalogService:1.0.0 


WAN Traffic Manager Services 


Novell: IpWanmanService:1.0.0=Novell:DfgWanmanService:1.0.0 





Secure Authentication Services 


Novell:SecuritySASInstall1:1.0.0=Novell:SecuritySASModule:1.0.0,Novell:PKIModu 
le:1.0.0,Novell:NICIModule:1.0.0 
Novell:SecuritySASModule:1.0.0=Novell:SASFiles:1.0.0 
Novell:PKIModule:1.0.0=Novell:PKIFiles:1.0.0 
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Novell PKI Services 


Novell:PKIInstall:1.0.0=Novell:PKIModule:1.0.0,Novell:NICIModule:1.0.0 
Novell:PKIModule:1.0.0=Novell:PKIFiles:1.0.0 


Novell Internet Access Server 


Novell:RAS:4.1.0=Novell:RAS Server 
Files:1.0.0,Novell:SVCDEF_NODE:1.0.0,Novell:Supported0S:1.0.0,Novell:UpgradeF 
rom:1.0.0 
Novell:RAS Server Files:1.0.0=Novell:RAS System Connect:1.0.0,Novell:RAS System 
Connect Scripts:1.0.0,Novell:RAS Public:1.0.0 














Storage Management Services 
Novell:SMS:1.0.0=Novell:SMSFiles:1.0.0 
Novell: SMSFiles:1.0.0=Novell:SMSSystemFiles:1.0.0,Novell:SMSPublicFiles:1.0.0 


Novell DNS/DHCP Services 


No additional keys and values are used for the installation of this service. 


Additional Services 


Two of the additional services available with NetWare, LDAP Services and 
Novell® DNS/DHCP Services, have data input screens for their configuration. 
These services have response file sections that must be included in addition to 
the keys and values mentioned above. 


NOTE: Be sure to use the proper case (upper or lower) when entering any of these 
keys and values. 


[LDAP] Section 


prompt = <string> 





Default (none) 

Values true or false 

Key Required Yes 

Example prompt=false 

Purpose Controls whether the LDAP configuration screen is 
displayed. 
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adminlD = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





(none) 

(NDS distinguished name) 

Yes 

adminID=.CN=admin.O=install 

Identifies the Admin name and NDS context; this should 
correspond with the Admin Login Name and Admin Context 


identified in the NWI:NDS section of the response file. Note 
the case of the characters in the string. 


installCatalog = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


useCatalogOnly = 


Default 
Values 

Key Required 
Example 


Purpose 
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(none) 

true or false 

Yes 

installCatalog=false 

Controls whether an LDAP catalog is installed. 


Corresponds to the question: Enable use of LDAP 
catalog? 


<string> 


(none) 

true or false 

Yes 

useCatalogOnly=false 

Controls whether the LDAP catalog is used exclusively for 


searching. Corresponds to the LDAP screen prompt: 
Catalog Usage for Searching. 


[Novell:DNS_DHCP:1.0.0] Section 


Prompt = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


None 

true or false 
Yes 
Prompt=false 


Controls whether the DNS/DHCP configuration screen is 
displayed. 


TreeName = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

(text) 

Yes 
TreeName=Novell 


Specifies the NDS tree name in which DNS/DHCP 
Services will be installed. 


UserName = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





(none) 

(NDS distinguished name) 

Yes 

UserName=.CN=admin.O=install 

Identifies the Admin name and NDS context; this should 
correspond with the Admin Login Name and Admin 


Context identified in the NWI:NDS section of the response 
file. Note the case of the characters in the string. 
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ExtendDNIPSchema = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


(none) 

true or false 

Yes 
ExtendDNIPSchema=true 


Controls whether the schema is extended for DNS/DHCP 
Services. Note that this should be set to true. 


LocatorNDSContext = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





(none) 

(NDS distinguished name) 
Yes 
LocatorNDSContext=O=install 


Identifies the NDS context that the Locator Object is to be 
installed into. 


GroupNDSContext = <string> 





Default 
Values 

Key Required 
Example 


Purpose 
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(none) 

(NDS distinguished name) 
Yes 
GroupNDSContext=O=install 


Identifies the NDS context that the Group Object is to be 
installed into. 


RootSrvrNDSContext = <string> 


Default (none) 

Values (NDS distinguished name) 

Key Required Yes 

Example RootSrvrNDSContext=O=install 

Purpose Identifies the NDS context that the RootSrvr Zone is to 


be installed into. 


In addition to the DNS/DHCP keys identified above, there must also be a line 
in the [Settings] section with the entry: Novell: DNS_DHCP:1.0.0= 


CD Boot and the Response File 


There are two options available for passing a response file into the NetWare 
installation: using the /RF switch at the command line, or from the Install 
Options screen. 


If you start the install by booting directly to the NetWare CD, you cannot pass 
in the response file automatically unless you have a RESPONSE.TXT file in 
the CANWUPDATE directory. When the NetWare CD is booted, the startup 
utility checks for a RESPONSE.TXT file in the CANWUPDATE directory. If 
such a file exists, the installation program bypasses the DOS partitioning 
utility and uses RESPONSE.TXT as the input response file. 


Customizing the Installation Using Install Scripts 


In NetWare, install scripts are supported by the NWCONFIG utility and the 
NetWare installation system. 


NOTE: For more information on using install scripts, see Automating the NetWare 
Installation with a Response File (http://www.developer.novell.com/research/ 
appnotes/1998/december/a1frame.htm) and More About Automating the NetWare 
Installation with a Response File (http:/Awww.developer.novell.com/research/ 
appnotes/1999/february/a3frame.htm). 
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There are two places in the NetWare installation where you can use install 


scripts: 


+ At the end of the preliminary file copy (just prior to the launching of the 
graphical portion of the install). An install script executed here can be 
used for copying files from the DOS partition to the SYS volume. 


+ At the end of the NetWare installation. It is called right after you answer 
AOK@ or ANo@ on the closing screen and before the install cleanup 
process. This script is useful if you want to manage files and launch NLM 
programs (for example, those that install other products) as part of the 
NetWare installation. 


The following response file syntax is used to run install scripts during the 


NetWare installation: 


[NWI:Install Script] Section 


Script Location = <string> 





Default 
Values 

Key Required 
Example 


Purpose 
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None 

(existing DOS path up to 255 characters) 

No 

Script Location = C:\NWUPDATE\PRECOPY.IC? 


Identifies the filename and path of an Install Script that will 
be executed at the end of the preliminary file copy (prior to 
the launching of the graphical portion of the install). 


NOTE: Usage of the ? wildcard in the extension of the 
filename will suppress an error if the specified file does not 
exist. 


Support Pack Script = <string> 


Default 
Values 
Key Required 


Example 


Purpose 


Close Script = <string> 


Support Pack Script = C:\spack\silent.ics 
(existing DOS path up to 255 characters) 
No 


If the support pack image is located on the C: drive, use this 
path: Support Pack Script=c:\nw51sp1\spack.ips 
e=c:\facterr.log s=c:\nw51sp1 


If the support pack image is ona mounted CDROM, use this 
path: Support Pack Script=NW51:\spack.ips e=c:\err.log 
s=NW51:\ 


If the support pack image is on a remote server, use this 
path: Support Pack script=prv- 
athena\images:nwo\cobra\sp1 128.524\spack.ips 
TRANSPORT=IPX u="SITESTER2" 
a=01010155:000000000001:0451 DS 
c="CN=SITESTER2.0U=INSTALL.OU=DEV.O=NOVELL" 
z=PRV-ATHENA-TREE e=C:\err.log s=PRV- 
ATHENA\IMAGES:NWS5\COBRA\SP1 128.524 


Identifies the filename and path of an Install Script that will 
be executed at the end of the install. 





Default 
Values 

Key Required 
Example 


Purpose 


None 

(existing DOS path up to 255 characters) 
No 

Script Location = SYS1OTHER.ICS 


Identifies the filename and path of an Install Script that will 
be executed when the final screen of the NetWare server 
installation is closed. 


NOTE: This script is executed just prior to some 
housekeeping that is done by the Close Screen routine. 
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Performing a Factory Install 


A Factory Install can reduce the complexity and time spent on an installation. 
Much of the hardware configuration and file copy is done in the Factory so 
that you only need to use the graphical portion of the NetWare installation to 
complete the on-site configuration. Because the network operating system 
files are pre-copied to the server, installation time is reduced to a few minutes. 


A Factory Install splits the installation of NetWare into two phases: 


+ Phase | performs the disk detection, disk partitioning, volume SYS 
creation, and file copy portions of the install. This phase is meant to be 
performed in a factory or configuration center. 


+ Phase 2 focuses on user configuration. It includes the setting of the server 
name, protocol binding, creation of volumes other than SYS, and 
configuration of time zone, NDS, licensing, and other products. This 
phase is meant to be performed by the customer at the server’s permanent 
location. 


Once Phase | is completed, the machine should be rebooted or powered off. 
When the machine is powered on and the server is started, the 
AUTOEXEC.NCF file will launch Java* for Phase 2 of the installation. 


A Factory Install is implemented with the response file sections below. A 
default Factory Install response file can be created by combining the 
FACTORY.TXT and RESPONSE.TXT files found in the INSTALL directory 
of the NetWare Operating System CD. 


he Preinstall key of the [NWI:Factory] section is the primary key that directs 
the NetWare Installation to perform a factory install. The Precopy key of the 
other sections specifies whether the file group should be recopied during the 
final file copy routine of the NetWare Installation. If Precopy=True, the files 
will be verified, but not copied. The Installation will appear, however, as if it 
is copying the files because you will see each file name displayed in the copy 
status box. 


NOTE: The NetWare CD must be inserted in Phase 2 of the Factory Install in order 
to perform this file verification. 


All other required keys for an automated install must also be included in the 
response file. See “Performing a Fully Automated Installation” on page 78 for 
more information. 
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[NWI:Factory] Section 


Preinstall = <string> 





Default 
Values 

Key Required 
Example 


Purpose 





Copy Products to SYS = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


Remove Directory = <local path> 


Default 
Values 

Key Required 
Example 


Purpose 





True 

True or False 

Yes 

Preinstall = True 

Controls whether the Factory Install option of the NetWare 


installation is invoked. If Preinstall=True, the remaining keys 
are checked. 


False 

True or False 

No 

Copy Products to SYS = True 

Controls whether the products directory of the NetWare 
Installation CD is copied to volume SYS so that products can 


be selected and installed during Phase 2 without the need for 
a NetWare Operating System CD. 


(none) 

(existing DOS path up to 255 characters) 
No 

Remove Directory = SYSAPRODUCTS 


Removes a directory from the system at the end of Phase 2. 
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[Novell:StartupDirectory:1.0.0] Section 


Precopy = <string> 





Default True 

Values True or False 

Key Required No 

Example Precopy = True 

Purpose Controls whether the files in the \STARTUP\NLS directory of 


the install image and destined for the 
C:\Startup_Director,\NLS directory are copied in Phase 2. If 
Precopy = True, the files are not copied again in the final file 
copy routine. 


[Novell:SYSDirectory:1.0.0] Section 


Precopy = <string> 





Default True 

Values True or False 

Key Required No 

Example Precopy = True 

Purpose Controls whether the files in the \STARTUP\NLS directory 


of the install image and destined for the 
C:\Startup_Director\NLS directory are copied in Phase 2. 
If Precopy = True, the files are not copied again in the final 
file copy routine. 
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[Novell:ConfigDirectory:1.0.0] Section 


Precopy = <string> 





Default True 

Values True or False 

Key Required No 

Example Precopy = True 

Purpose Controls whether the files in the \CONFIG directory of the 


install image, destined for volume SYS, are copied in 
Phase 2. If Precopy = True, the files are not copied again 
in the final file copy routine. 





[Novell:LANFiles:1.0.0] Section 


Precopy = <string> 


Default True 

Values True or False 

Key Required No 

Example Precopy = True 

Purpose Controls whether the LAN files in the \DRIVERS\LAN 


directory of the install image, destined for the 
SYS:SYSTEM directory, are copied in Phase 2. If Precopy 
= True, the files are not copied again in the final file copy 
routine. 
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[Novell:SBDFiles:1.0.0] Section 


Precopy = <string> 





Default True 

Values True or False 

Key Required No 

Example Precopy = True 

Purpose Controls whether the files in the \DRIVERS\SBD directory 


of the install image, destined for the SYS:SYSTEM 
directory, are copied in Phase 2. If Precopy = True, the files 
are not copied again in the final file copy routine. 





[Novell:portalzip:1.0.0] Section 


Precopy = <string> 


Default True 

Values True or False 

Key Required No 

Example Precopy = True 

Purpose Controls whether the files in the zip file destined for volume 


SYS are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 
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[Novell:Rconjzip:1.0.0] Section 


Precopy = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for 


volume SYS, are copied in Phase 2. If Precopy = True, the 
files are not copied again in the final file copy routine. 





[Novell:Perl5zip:1.0.0] Section 


Precopy = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for volume 


SYS, are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 
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[Novell:beanszip:1.0.0] Section 


Precopy = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for volume 


SYS, are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 


[Novell:nscriptzip:1.0.0] Section 


Precopy = <string> 


Default 
Values 

Key Required 
Example 


Purpose 
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True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for volume 


SYS, are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 


[Novell:scripteszip:1.0.0] Section 


Precopy = <string> 


Default 
Values 

Key Required 
Example 


Purpose 





True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for volume 


SYS, are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 





[Novell:console1zip:1.0.0] Section 


Precopy = <string> 


Default 
Values 

Key Required 
Example 


Purpose 


True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for volume 


SYS, are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 
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[Novell:Idapzip:1.0.0] Section 


Precopy = <string> 





Default 
Values 

Key Required 
Example 


Purpose 


True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for volume 


SYS, are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 


[Novell:wanmanzip:1.0.0] Section 


Precopy = <string> 


Default 
Values 

Key Required 
Example 


Purpose 
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True 

True or False 

No 

Precopy = True 

Controls whether the files in the zip file, destined for volume 


SYS, are copied in Phase 2. If Precopy = True, the files are 
not copied again in the final file copy routine. 


Install Command Line Options 


The following command line options that can be used when initiating the 
installation executable. 


ISERVER_LOG = <string> 


Default (none) 

Values (existing DOS path up to 255 characters) 

Key Required No 

Example Install /LOG=C:\TMP\ERROR.LOG 

Purpose Designates where an installation log file will be created. 





MPX <decimal number> or /SERVER_ID <hexadecimal number> 





Default (none) 

Values 1 - FFFFFFFF 

Key Required No 

Example Install /IIPX 38483933 or Install\SERVER_ID 
38483933 

Purpose Allows a specific internal net address to be used for the 


server being installed. 
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Installation Scripts for NetWare 


WARNING: This document describes software that is subject to change. Novell® 
intends to keep it as current as possible, but the user must assume any inherent 

risk in developing or maintaining code based on the information in this document. 
Novell may discontinue or decline to support any software feature described within 
this document at any time. 


This chapter describes the installation script support for NetWare®. NetWare 
installation scripts let you: 


+ Alter or extend the NetWare pre-packaged installation process. 


¢ Install additional products or services onto a NetWare server after the 
operating system has been installed. 


Using NetWare Installation Scripts 


Script Files 


NetWare installation scripts in NetWare 6 are processed by the 
NWCONFIG.NLM program. 


NOTE: NetWare 4 uses INSTALL.NLM to process script commands. 


Script files are ASCII text files. They can have any eight-character name with 
one of the following extensions: 








Extension Type of File 
APS Individual product installation 
ACS Common functionality between scripts or non-language 


specific scripts 





ALS Language-specific functionality 
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Launching a Script File 
4 At the server console, enter NWCONFIG.NLM. 
2 Click Products Options on the Configuration Options screen. 
3 Click Other Installation Actions menu > Install a product not listed. 


4 Press F3, and then specify the directory path to the script file. 


The directory path is first checked for an IPS file. If only one .IPS file exists, 
it is executed. If more than one exists, only the first one found is executed. If 
there is no .IPS file, PINSTALL.NLM will be loaded and executed. The first 
@Other...@EndOther descriptor found in the .IPS file is displayed so that you 
can confirm the product being installed. 


The NetWare install program also loads any file that contains the command 
line parameter “B=”. For example, a script can be launched by entering LOAD 
NWCONFIG b=A:\myscript .IPS (where myscript stands for the name 
of your .IPS file). 


Using a Script with NetWare 6 


There are two points in the installation where scripts can be launched: 


+ At the end of the preliminary file copy just prior to the launching of the 
graphical portion of the installation. 


+ At the end of the installation. 
See Using a Response File with NetWare for more information. 


The NetWare installation program uses one installation script 
(NETWARE.ILS) during the text-based file copy. You can modify this script 
file to copy additional files or launch additional processes, but we do not 
recommend it. 
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Descriptors and Commands 


This section describes the descriptors and commands found in 
NETMAIN.ILS and other installation script files. The product installation 
script files you write contain the same types of descriptors and commands as 
those in NETMAIN.ILS. 


A descriptor is a keyword preceded by the @ character. The installation NLM 
scans the descriptors and uses them to build linked lists and menus in memory. 
Descriptors 


+ Describe a configuration or presentation, but do not specify a procedure 
or order. 


+ Are typically block-oriented (with an @Command and an 
@EndCommand statement), although some are single-line. 


+ Are declarative in nature. 
+ Cannot be nested. 
A command is a keyword not preceded by the @ character. Commands are 


+ Procedural, describing the method and order of installation (creating 
directories, copying files, etc.). 


+ Usually grouped within an @FileSet...@EndFileSet descriptor block 
(although they can also exist independently). 


+ Executed in order, according to the script file. 


Script files can be natural-language-enabled by using text within double 
quotes (in-line text). Such text is designated for language translation, 
including text that will be displayed in menu items, help text, etc. 


Syntax Conventions 
+ Commands and arguments are not case-sensitive, but prompt strings are. 


+ A script parser recognizes the following special characters: 


E A] 


If a special character is used within a name, the entire name must be 
surrounded by double or single quotation marks. 
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Comments 


Syntax 


Description 


Example 


Descriptors 


@CDName 


+ ANSI escape sequences are recognized by the parser within double or 
single quotes. For example, “W, "\n", and Mt' represent a backslash, a new 
line, and a tab, respectively. 


+ A NULL character (ASCII value 0) is not allowed anywhere in the file. 


7 <text> 


A comment (semicolon followed by text) exists for documentation purposes 
only—it does not invoke a script file operation. Comment characters through 
the end of a line are read and discarded. 


; THIS IS A COMMENT 


Syntax 


@CDName <name> 


Description 


@CDName specifies the name of the CD-ROM volume being installed. This 
name is passed to CDROM.NLM in a MOUNT command (CD MOUNT 
<name>) to mount the CD-ROM as a NetWare volume. This descriptor should 
only be used in a script on a CD-ROM. It should not be used in a diskette drive 
installation script. Copy CDROM.NLM to the STARTUP directory as 
specified in the BOOT fileset. 


Example 
@CDName NETWARE5 
The installation will use the string NETWARES when trying to mount the 


CD-ROM as a NetWare volume. After successfully loading CDROM.NLM, it 
will issue CD MOUNT NETWARES at the system console. 
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@DeletePartition 


Syntax 


@DeletePartition <comma-separated list of partition types> 


Description 


@DeletePartition deletes the existing partitions that you specify. In contrast, 
the installation NLM’s automatic partition creation deletes (by default) 
existing partitions of the first two types listed below. In both cases, all active 
partitions are left untouched. 





Partition Type Description Deleted? 
64 NetWare 286 Yes 
65 NetWare 386 Yes 
01 DOS, 12-bit FAT No 
04 DOS, 16-bit FAT No 
05 Extended partition No 
06 DOS Huge partition No 


If any of these partitions should not be deleted, or if additional partitions need 
to be added, use @DeletePartition to replace the list. 


Example 


If the following appears in NETMAIN.ILS, only NetWare 386 partitions are 
eligible for deletion: 


@DeletePartition 65 
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@Driver 
@EndDriver 


Syntax 


@Driver 
Help: “Help description for finding drivers” 
[Dir: <DSK | LAN>, <subdirectory name>, <vol label>, 
<disk description>] 
[Dir: <DSK | LAN>, <subdirectory name>, <vol label>, 
<disk description>] 





@EndDriver 
Description 


@Driver specifies help for finding drivers in maintenance-mode installations, 
or finding disks and directories that contains drivers. <subdirectory name> 
specifies the directory to read. For floppy or network installations, the 
subdirectory will typically be NULL. For a CD-ROM, the subdirectory will 
usually be the common directory where drivers are found. <vol label> is the 
corresponding media volume name, and <disk description> specifies the 
printed name on the media that contains the included file. Use @Driver in the 
NETMAIN.ICS file. 





Variable Description 





<subdirectory name> Specifies the directory to read. For floppy or network 
installations, the subdirectory is typically NULL. Fora 
CD-ROM, the subdirectory is usually the common 
directory where drivers are found. 





<vol label> Specifies the name of the corresponding media volume. 





<disk description> Specifies the printed name on the media that contains 
the include file. 
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@FileSet 
@EndFileSet 


Example 


(Driver 
Help: “If installing from a floppy, disk drivers will be 
on disk NetWare-2 and LAN drivers will be on disk 
NetWare-3. If installing from CDROM, all drivers will be 
in the directory <cdrom drive>:\NW40\SERVER\DRIVERS.” 
Dir: DDSK, '', 'NETWARE-2', 'NetWare-2' 
Dir: LAN, '', 'NETWARE-3', 'NetWare-3' 


@EndDriver 


Disk NetWare-2 will be scanned for .DSK and .DDI files; disk NetWare-3 will 
be scanned for .LAN and .LDI files. 





Syntax 

@FileSet 
Description: “...[fileset description]...” 
Class: {MANDATORY | CORE | OPTIONAL | OPTIONAL_OFF 
BOOT) 


Name: <text name - no spaces allowed> 

Bytes: <total transfer size for this fileset> 
[DiskBytes: <total disk space for this fileset>] 
[Attribute: <attributel>, <attribute2>] 

[Flags: <flags>] 

<fileset commands...See “Syntax” on page 104.> 
EndFileSet 


© 





Description 


@FileSet specifies a logically similar group of files to be copied and the 
necessary commands for copying and installing those files. 


The Description and DiskBytes information for OPTIONAL and 
OPTIONAL OFF classes of filesets is displayed in a menu before copying. 
The description for all filesets are displayed during the file copy. Bytes are 
used to update a status bar representing the total bytes to copy for all selected 
filesets, which is used in displaying the status bar. 
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Class specifies how the fileset will be used: 








File Action 
MANDATORY Always executed. 
CORE Always copied in a sequential install, but optionally 


copied in the selective install/maintain mode. 











OPTIONAL Displayed to the user for selection. They are defaulted 
to on (selected for copy). 

OPTIONAL_OFF Displayed for the user to choose, but are defaulted to 
off. 

BOOT Copied, depending on the kind of installation and 


whether the server was launched from the directory 
that the user is installing to. 


For all classes, as the files are copied, the file group status is also displayed, 
including the file being copied and the percent of all the filesets that have been 
completed. 


Name is used to relate logical filesets together, even when they are declared in 
different included files. If multiple filesets exist with the same logical name, 
there can be only one description and one class for all of them. For example, 
if multiple filesets with the name OS2 are declared, and the class is 

OPTIONAL, only one description entry for the OS2 files is presented for the 
user to select. If the user selects it, all filesets with the name OS2 are copied. 


BOOT files are files such as SERVER.EXE, SERVER.MSG, 
NWCONFIG.NLM, NWCONFIG.MSG, NUT.NLM, and NUT.MSG. The 
BOOT filesets are for internal use only: product files should not have any 
BOOT fileset declarations. Boot files cannot be compressed or renamed. 


Attribute value indicates the final file attributes.The default value for 
attributel is 00060081 (Read Only, Shareable, Rename Inhibit, Delete 
Inhibit). 
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For a DOS file: 



























































Attribute1 Meaning 
00000001 Read Only 
00000002 Hidden 
00000004 System 
00000008 Volume Label 
For a NetWare file: 
Attribute1 Meaning 
00000001 Read Only 
00000002 Hidden 
00000004 System 
00000008 Execute 
00000010 Subdirectory 
00000020 Archive 
00000080 Shareable 
00000700 Smode 
00001000 Transaction 
00004000 Read Audit 
00008000 Write Audit 
00010000 Immediate Purge 
00020000 Rename Inhibit 
00040000 Delete Inhibit 
00080000 Copy Inhibit 
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The meaning for Attribute2 is 00000001 (do not decompress or process file). 
The default for Attribute2 is zero, which should be used in all usual 
































circumstances. 
Flag Meaning 
00000001 Do only for a custom install. 
00000002 Do in first-phase copy (bit reset = second-phase). 
00000004 Do only if NetWare for OS/2*. 
00000008 Do only if native (not SFT III™ or NetWare for OS/2). 
00000010 Do only if SFT III. 
00000020 Do only for a simplified installation. 
00000040 Do only for maintenance mode. 
00000080 Do only for upgrade. 
00000100 Do only if installing from front end (NWNSTLL.EXE). 
00000200 Do only if not installing from front end 
(NWNSTLL.EXE). 
Example 
@FileSet 


Class: CORE 
Name: SYSTEM_FILES 
Description: “System Files” 
Bytes: 10192463 
CopyToServer 'SYSTEM', '*.*', 'SYSTEM-1', “NetWare 
System-1 Files” 
@EndFileSet 


In this example, *.* files are copied from volume SYSTEM-1:, and the 
percent of complete status for this fileset is displayed during copying. 
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@lncludeFile 
@EndincludeFile 


Syntax 


@IncludeFile 
File: <filename> 
[DiskDescription: “...[disk description]...”] 
[DiskVolume: 11 char vol name>] 
@EndIncludeFile 





Description 


@lIncludeFile specifies a file (<filename>) with additional commands to parse 
and execute. DiskDescription specifies the printed name on the media that 
shows where the include file is located; Disk Volume is the corresponding 
media volume name. 


The command file's directory is searched first. If the include file is not there, 
the specified disk volume is checked. If <filename> is a <path>\<file> 
combination, the command file directory is checked first for <file>, then the 
disk volume at the <path> offset is checked. If <file> includes wildcard 
characters, all files matching the pattern are included. If the filename has 
wildcards but no files match, none are included, and no error results. If the 
filename does not have wildcards, and the file is not present, an error occurs. 
If the filename is in single quotes and contains %{NWLANG}, 
%{NWLANG} is replaced by the language number (4=English). 


Example 


For the NETMAIN.ILS file, where NETMAIN.ICS is not in the same 
directory as NETMAIN.ILS: 


@IncludeFile 
File: NETMAIN.ICS 
DiskDescription: '[1]' 
DiskVolume: SYSTEM-1 
@EndIncludeFile 


The file is parsed just after the @EndIncludeFile statement. If the installation 
cannot find NETMAIN.ICS in the directory where NETMAIN.ILS is, it 
prompts for the CD, then reads and parses NETMAIN.ICS from the CD. 
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@MessageFile 
@EndMessageFile 


Syntax 


@MessageFile 

File: <filename> 

[Version: <message file version number>] 
@EndMessageFile 





Description 


@MessageFile specifies a file, usually with the extension .MSG, containing 
message strings. It is typically located in the same directory as the script file 
or in an NLS subdirectory. When <message file version number> name 
variables are encountered when the remainder of the script file is parsed 
(including @Include files), the symbols are substituted with definitions from 
the message file. 


The search order of message files is: 
1. The current directory. 
2. The NLS directory corresponding to the current language. 


3. The default definitions of <message file version number> “string.” 


The Version number is eventually used to synchronize the script file with the 
messages. If no version is specified, version checking is not performed. 
Currently, no version checking is performed, regardless of whether the 
@Version descriptor is present. 


Example 


Using the NETMAIN.ILS file (in the same directory as NETMAIN.MSG): 


@MessageFile 
File: NETMAIN.MSG 


@EndMessageFile 


NETMAIN.MSG is read into memory and used to dereference <message file 
version number> strings. 
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@StartAppObject 
@EndAppObject 


Syntax 


@StartAppObject 


AppPlatform: <Supported Platforms> 
AppName: <Name of the object to create> 
AppPath: <UNC Path to the executable> 


AppDescription: “...Text...”] 

AppContact: <List of contacts>] 

AppMapping: <List of drive mappings>] 
AppFlags: <>] 

AppIcon: <Filename of Icon>] 

AppCaption: “...Text...”] 

AppParameters: <List of Parameters for AppPath>] 
AppPrinter: <Printer Ports>] 
AppShutdownScript: <Filename of Script>] 
AppStartupScript: <Filename of Script>] 
AppWorkingDir: <Startup directory for App>] 
AppUser: <List of users>] 

AppAdminNotes: “...Text...”] 








Oo 


Description 


AppFaultTolerance: <List of fallover apps>] 
AppLoadBalancing: <List of load balancing apps>] 
EndAppOb ject 


Use @StartAppObject to create NDS objects for use with the Novell® 
Application Launcher™ (NAL) product. It is used with NetWare for Small 

















Business. 

Variable Description 

AppPlatform The list of supported platforms the Application object can 
run on. 

AppName The NDS name of the object as viewed in NetWare 
Administrator. 

AppPath The UNC path and filename of the executable to be 
launched by the object. 

AppDescription The description that shows on Novell Application 


Launcher. 
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Variable Description 


AppContact The list of usernames to contact for resolving issues with 
the Application object. 

















AppMapping A list of drive mappings that are made for the application 
to run correctly. 

Appicon The filename and location of the applications icon. 

AppWorkingDir The startup directory for the application. 

AppUser A list of users authorized to run the application. 

Example 

EStartAppObject 


AppPlatform: 3x 95 NT 

AppName: “Netscape Install” 

AppPath: “SYS\\PUBLIC\\NETSCAPE\\NTSCINST. EXE” 

AppCaption: “Netscape Install” 

AppDescription: “Install the Netscape Internet browser” 

AppContacts: admin 

AppFlags: “No Cleanup” 

AppIcon: “sys:public\\netscape\\netscape.ico” 

AppWorkingDir: “sys\\public\\netscape” 

AppUsers: “All Users” Action Standard Desktop 
@EndAppOb ject 


This example creates an NDS Application object named Netscape* Install. 
When NAL is run, this object will let the user install it to their desktop. 


@Other 
@EndOther 
Syntax 
@Other 
Description: “...[text]...” 
[DiskDescription: “...[disk description]...”] 


[DiskVolume: <11 char vol name>] 
[File: <filename>] 
[Flags: <flags>] 

EndOther 





© 
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Description 


Description is the menu description displayed for the @Other configuration 
option. This label must be first in the set of labels for a particular @Other 
option. 


File specifies the *.IPS file to execute, or the NLM to load to install the 
@Other option. 


DiskDescription is the prompt name that will be displayed to the user to 
prompt for another diskette. 


Disk Volume is the volume name for the disk specified in DiskDescription. If 
the Disk Volume label is present, the user is prompted for the specific volume 
using DiskDescription from drive A: (the user can change the drive). This 
continues until the file is found or the user cancels. If no Disk Volume is 
present, Install prompts for another diskette in drive A: and continues until the 
file is found (if File is present) or the user cancels. If File is not specified, 
installation looks for any *.IPS or PINSTALL.NLM files. 
































Flag Meaning 

00000001 Load product environment (clib, btrieve, product.dat). 

00000002 Product included in product box (NETMAIN.ILS 
description). 

00000004 Display product should be displayed in simplified 
installation. 

00000008 Display product only in simplified installation. 

00000010 Display product only in maintenance installation. 

00000020 Display product only in upgrade. 

00000040 Display product only in NetWare for OS/2 install. 

00000080 Display product only in native installation. 

00000100 Display product only in SFT III installation. 

00000200 Display product only if started from front end 


(NWNSTLL.EXE). 





00000400 Display product only if not started from front end 
(NWNSTLL.EXE). 
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@SyntaxVersion 


If the other filename extension is .IPS, the file is assumed to be a script and is 
interpreted. If the other filename extension is .NLM, the file is loaded and 
executed as an NLM. 


Example 


@Other 
Description: “Install NetWare for Macintosh” 
DiskDescription: 'NWM System 1' 
DiskVolume: 'MAC-1' 
File: PINSTALL.NLM 


Description: “Install TCP/IP Protocol” 
DiskDescription: 'TCPIP System 2' 
DiskVolume: 'TCPIP-2' 

File: TCPIP.IPS 


@EndOther 


The Install NetWare for Macintosh* and Install TCP/IP Protocol menu items 
are displayed. If NetWare for Macintosh is selected, the user is prompted for 
the NWM System 1 CD, then PINSTALL.NLM on volume MAC-1: is 
executed. If TCP/IP is selected, the user is prompted for the TCPIP System 2 
CD, then the command file TCPIP.IPS is interpreted. 


Syntax 


@SyntaxVersion <major version>.<minor version> 


Description 


The Syntax Version string represents the version of the script file parser. The 
Syntax Version string should be present for all script files, and the syntax 
version of the parser must match that of the file. 


Example 


@SyntaxVersion 1.02 


The internal syntax string in the installation utility will be compared with this 
string. If they do not match, the installation will prompt for a different file. All 
included scripts with a @Syntax Version descriptor will be checked for 

matching version strings (see “@IncludeFile @EndIncludeFile” on page 111). 
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@StartSchemaMod 


@EndStartSchemaMod 


@TimeZone 
@EndTimeZone 


Syntax 


@StartSchemaMod 
SchemaFileName: 
EndSchemaMod 





<Filename>, <Description> 


@ 





Description 


@StartSchemaMod lets NDS schemas be extended through installation 
scripts. 


SchemaFileName specifies the filename for the schema file, along with a 
Description for displaying to the screen during the modification. 


Example 

@StartSchemaMod 
SchemaFileName: “sys:\\system\\schema\\nwadmin.sch”, 
“NetWare Administrator” 

@EndSchemaMod 


In this example, the NWADMIN.SCH file extends the NDS schema and 
displays “NetWare Administrator” on the screen during the installation of 
Directory Services. 


Syntax 


@TimeZone 
Description: 
Standard: 


<tz description> 

<tz abb.>, <tz adj.> 
[Daylight: <dst abb.>, <dst adj.>] 
[DSTStart: <start rule>, <seq number>, 
<weekday number>, <month number>, 
[DSTEnd: <end rule>, 
<weekday number>, 

EndTimeZone 


<day number>, 
<time>] 

<day number>, 
<time>] 











<seq number>, 
<month number>, 


© 





Description 


Description specifies a time zone description to be displayed to the user during 
time services installation. 
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Standard specifies information to be displayed to the user once the time zone 
has been selected. This includes the time zone abbreviation and the adjust +/- 
X:Xx:xx from GMT (Greenwich Mean Time) or UTC (Universal Coordinated 
Time). 


If Daylight exists, it specifies that daylight savings time exists for part of the 
year. It also specifies the daylight abbreviation, and the adjust +/-x:xx:xx from 
standard time. 


DSTStart and DSTEnd specify the rule (w for weekday of month or d for day 
of month), the sequence number (1-relative), day number (1-relative), 
weekday number (1-relative), month number (1-relative), and time on a 24- 
hour clock for daylight savings time. 





Sequence number means: 





























1 First (ignore day number) 
2 Second (ignore day number) 
3 Third (ignore day number) 
4 Fourth (ignore day number) 
5 Fifth (ignore day number) 
6 Last (ignore day number) 
7 >= day number 

8 <= day number 

Example 

@TimeZone 


Description: “United States, Mountain Time Zone”, 
Standard: “MST”, '7:00' 

Daylight: “MDT”, '+1:00' 

DSTStart: w, 1, 1, 1, 4, '2:00' 

DSTEnd: w, 6, 1, 1, 10, '2:00' 


Description: “United States, Central Time Zone”, 
Standard: “CST”, '6:00' 

Daylight: “CDT”, '+1:00' 

DSTStart: w, 1, 1, 1, 4, '2:00' 

DSTEnd: w, 6, 1, 1, 10, '2:00' 


@EndTimeZone 
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@TranslateModule 


Two time zone descriptions are displayed. When one is selected, the time 
parameters are filled in according to the above information, and the user can 
verify or edit them. 


@EndTranslateModule 


@Version 


Syntax 


@TranslateModule 
<old driver namel>,<new driver namel>, 
<old driver name2>,<new driver name2>, 








@EndTrandlateModuel 





Description 


@TranslateModule is used internally by NETMAIN.IES. It specifies that a 
disk or LAN driver name has been changed for the previous release. The name 
will be changed in the STARTUP.NCF or AUTOEXEC.NCF file during an 
upgrade. 


Syntax 


@Version <major version>.<minor version> 


Description 


The @Version string represents the version of the script file (and its 
corresponding script data). For the NETMAIN.ILS script file, @ Version must 
be greater than or equal to the expected version of the installation NLM. Ifany 
included script files contain version numbers, all the numbers must match. 
@Version should be incremented each time a new script is released. 


In product scripts, the version string is entirely optional. A version string in a 
product script is not compared with the installation NLM, but all included 
product scripts must have matching version strings. 


Example 


@Version 1.01 
The version string in the installation is compared with this version string. If 
they do not match, the installation prompts for a different file. All included 


scripts with a @Version descriptor will be checked for matching version 
strings (see “@IncludeFile @EndIncludeFile” on page 111). 
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Commands 


Command 


Syntax 


Command <command handler name> 


Description 


Command specifies the name of an optional command handler for commands 
not included in this file. The command handler name must be eight characters 
or less and correspond to the name of an NLM that exports external command 
entry points. 


Example 
Command ICMD.NLM 
ICMD.NLM provides external command support (see “External Command 


Syntax” on page 126). It supports the command syntax described in this 
document, plus additional commands. 


CopyDriverToServer 


Syntax 


CopyDriverToServer <target_directory_path>, <file_spec>, 
<source_volume>, <source_description> 


Description 


CopyDriverToServer replaces driver files in <target_directory_path> with 
new driver files. The source files are assumed to be those on the distribution 
CD (which might have been copied to a user-specified directory). 


<file_spec> is the name of the file to be copied, and can be of the form *.LAN, 
* DSK, <directory>/*.LAN or <directory>/*.DSK. <source_volume> 
specifies the name of a diskette volume label and <source_description> 
specifies the string used to prompt for the diskettes. If the installation source 
is a CD-ROM or network drive, <source_volume> and <source_description> 
are ignored (although these fields must be present in the command). 


120 Other Installation Options 


Example 


CopyDriverToServer SYSTEM, '*.LAN', 'NETWARE-3', “NetWare 
diskette [3]” 


The *.LAN files are copied to the SYS:SYSTEM directory. 


CopyDriverToStartup 


CopyToServer 


Syntax 


CopyDriverToStartup <file_spec>, <source_volume>, 
<source_description> 


Description 


CopyDriverToStartup replaces driver files in the startup or boot directory 
(where STARTUP.NCF is) with new driver files. The source files are assumed 
to be those on the distribution CD (which might have been copied to a user- 
specified directory). <file_spec> names the files to be copied, and can be 

* LAN, *.DSK, <directory>/* LAN or <directory>/*.DSK. 
<source_volume> specifies the name of a diskette volume label and 
<source_description> specifies the string used to prompt for the diskette. If 
the installation source is a CD or network drive, <source_volume> and 
<source_description> will be ignored (although these fields must be present 
in the command). 


Example 


CopyDriverToStartup '*.LAN', 'NETWARE-3', “NetWare 
diskette [3]” 


The *.LAN files are copied to the user-designated DOS startup directory 
where the server boot files reside. 


Syntax 


CopyToServer <target_directory_path>, <file_spec>, 
<source_volume>, <source_description> 


Description 


CopyToServer specifies a file (or a group of files using wildcards) to copy to 
the system volume of the server. 
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CopyToStartup 


<target_directory_path> is a directory path relative to SYS: where the files 
will be copied. <file_spec> names the files to be copied; it might be in the 
“directory/file” form to copy files from a subdirectory. <source_volume> 
specifies the name of a diskette volume label and <source_description> 
specifies the string used to prompt for the diskettes. If the installation source 
is a CD-ROM or network drive, the <source_volume> and 
<source_description> fields are ignored (although these fields must be 
present in the command). 


Example 


CopyToServer 'SYSTEM', '*.*', 'SYSTEM-2', “NetWare 
diskette [4]” 


Files matching the DOS file specification (including DOS wildcard names) 
are copied from the volume SYSTEM-? (or from a user-specified hard disk or 
network directory) to directory SYS:SYSTEM. If the volume SYSTEM-2 is 
not present, the user will be prompted to insert the NetWare CD. 


Syntax 


CopyToStartup <file_spec>, <source_volume>, 
<source_description> 


Description 


CopyToStartup copies files to the startup or boot directory (where 
STARTUP.NCF is). The source files are assumed to be those on the 
distribution diskettes (which might have been copied to a user-specified 
directory). 


<file_spec> names the files to be copied. To copy files from a subdirectory, 
<file_spec> can be of the form “directory/file”. <source_volume> specifies 
the name of a diskette volume label and <source_description> specifies the 
string used to prompt for the diskettes. If the installation source is a CD or 
network drive, <source_volume> and <source_description> are ignored 
(although these fields must be present in the command). 


Example 


CopyToStartup 'SERVER.EXE', 'SYSTEM-3', “NetWare diskette 
[3] m 


SERVER.EXE is copied to the user-designated DOS startup directory where 
the server boot files will reside. 
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Exec 


ProductRecord 


Syntax 


Exec <filename> 


Description 


Exec issues the operating system command LOAD <filename>, pauses until 
the child NLM unloads, then continues executing. To load from other 
subdirectories of the system volume besides \SYSTEM, specify a filename 
(SYS:/<directory>/<file> and <directory>/<file>). 

Example 


Exec MY .NLM 


MY.NLM will be loaded and executed. Exec will follow the normal NLM 
search path to find MY.NLM. Control will return to the installation after Exec 
exits and unloads. 


Syntax 


ProductRecord <product ID (string)>, <record type>, <record 
data> 


Description 


ProductRecord creates a record in the product database with the ID string 
<product [D> and the record type and data indicated. 




















Record Type Data 

0 Version string (10 char max) 

1 Product description (60 char max) 

[2] Configuration NLM command line(255 char max) 
[8] Configuration text file specification (255 char max) 
[4] Un-install NLM command line (255 char max) 

[5] Delete AUTOEXEC line (255 char max) 
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RegisterLanguage 


SaveLanguageFile 


Record Type Data 








[6] Delete STARTUP line (255 char max) 
[7] Delete file line (255 char max) 
Example 


ProductRecord MYPROD, 1, “Description for my product” 


This creates a product description record for MYPROD with the quoted 
description. 


Syntax 


RegisterLanguage <language ID>, <language name> 


Description 


RegisterLanguage renames </anguage [D> to the respective name </anguage 
name>. This exists typically to allow non-standard languages to be registered 
when they are installed. 

Example 


RegisterLanguage 17, TURKISH 


This command aliases TURKISH to ID 17. 


Syntax 


SaveLanguageFile <file> 


Description 


SaveLanguageFile copies <file> in the DOS startup directory to the directory 
indicated by the old language ID <startup directory>/<old language ID>. This 
might involve creating a new directory. If the directory path for the new file 
does not exist, it will be created. 
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Example 

SaveLanguageFile SERVER.MSG 

If the current language ID is 4, SERVER.MSG in the DOS startup directory 
(BOOT directory) is copied to the subdirectory 4 in the DOS startup directory. 


Spawn 


Syntax 


Spawn <file name> 


Description 


Spawn issues the operating system command LOAD <file_name>, then the 
installation continues to execute. See “Exec” on page 123. 

Example 

Spawn MY.NLM 

The MY.NLM file is loaded and executed. Spawn follows the normal NLM 


search path to find MY.NLM. The installation and the child NLM both 
execute, sharing the CPU through context switches. 


External Commands 


This section describes commands provided by ICMD.NLM, a companion to 
the NetWare Installation NLMs (INSTALL.NLM and NWCONFIG.NLM). 
See “NetWare Installation Command Version Availability” on page 161 for a 
table showing the ICMD versions that support these commands. 


Version 2.10 External Command Compatibility 


If you intend to use ICMD.NLM 2.18 or greater, do not copy this new version 
to SYS:SYSTEM. Instead, copy it to a different directory and load it from 
there. 


For example, the script commands below will copy ICMD.NLM to a 
temporary directory and load from there. 


CopyToServer SYSTEM\TMP, ICMD.NLM, ““, ““ 
Command TMP\ICMD 
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Using this method ensures that the ICMD.NLM version in SYS:SYSTEM is 
the actual 4.10 version and that all built-in products that use it will work 
properly. The new ICMD.NLM might still be fully backward-compatible, but 
it has not yet been fully tested in that regard. 


External Command Syntax 


Commands 


Activate 


AppendFile 


To use any of the external commands made available by the ICMD.NLM 
command handler, include the statement command [<filepath>] ICMD in the 
script file. Use CopyToServer to copy ICMD.NLM to a temporary directory 
(for example, SYS:SYSTEM\TEMP), then use command to run it from there 
(for example, command SYS:SYSTEM\TEMP\ICMD). This removes any 
compatibility problems associated with using the standard ICMD.NLM in 
SYS:SYSTEM. You can create then add additional commands to your own 
version of ICMD.NLM (after you rename the file) to perform application- 
specific functions. 


Syntax 


Activate 


Description 

Activate causes the installation screen to be activated. 
Example 

Activate 


The installation screen will be displayed for further script processing. 


Syntax 


AppendFile <src var name>, <src file spec>, <src vol name>, 
<src descr>, <dest var name>, <dest dir>, <dest vol name>, 
<dest descr> 
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AppendTextToFile 


Description 


AppendFile appends the contents of the source file onto the destination file. It 
creates a temporary file that is as large as the destination file, then renames that 
file to the destination file. Wildcard characters for <src file spec> are not 
allowed. 


Example 


AppendFile input, filel, 'NETWARE-1', “NW [1]”, output, 
tilezyo NE 257 


The user is prompted for diskette NW [1], which is verified by checking for 
volume label NETWARE-1. The FILE1 on that diskette is appended to FILE2 
in the directory corresponding to output. 


Syntax 
AppendTextToFile <src var name>, <src file spec>, <src vol 


name>, <src descr, <text> 


Description 


AppendTextToFile appends the contents of the literal text onto the destination 
file. It also places a date timestamp with every entry. Wildcard characters for 
<src file spec> are not allowed. 


If the file is found, the value of variable NWSTATUS will be zero; otherwise 
it will be non-zero. 


Example 


AppendTextToFile input, filel, ‘NETWARE-1’, “NW[1]”, 
‘Installation Complete’ 


The user is prompted for disk NW[1], which is verified by checking for 
volume label NETWARE-1. The FILE1 on that disk will be appended to 
FILE2 in the directory corresponding to the output. 
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CheckFile 


Config 


Syntax 


CheckFile <var name>, <file spec>, <vol name>, <description> 


Description 


CheckFile checks for the existence of <file spec> at a path determined by the 
value of <var name>. If the path is a floppy, and <vol name> is non-null (not 
"), the user will be prompted for disk <description> if it is not already in the 
drive. 


If the file is found, the value of variable NWSTATUS will be zero; otherwise 
it will be non-zero. 
Example 


CheckFile NWSRC, filel.dat, '', '' 
GotoIfNEqual 'S(NWSTATUS)', 0, FileNotFound 
File found 


Label FileNotFound 


In this example, a check is made for a file (FILE1.DAT). If the file is found at 
the path determined by NWSRC, execution continues on the next line. If the 
file is not found, control branches to label FileNotFound. 


Syntax 


Config <flag> 


Description 


Config creates a configuration file with available default information from the 
installation. If <flag> is 1, AUTOEXEC.NCF is created on SYS:SYSTEM; if 
0, STARTUP.NCF is created in the server boot path. 

Example 


Config 1 


This command creates AUTOEXEC.NCF, with server name, internal net 
address, configured LAN driver load and bind commands, directory service 
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Console 


CopyFile 


and time services information. The existing AUTOEXEC.NCF on 
SYS:SYSTEM is overwritten. 


Syntax 


Console <text>, <delay in seconds> 


Description 


Console enters the text on the system console screen and delays <delay in 
seconds> before returning control back to the calling process. Because the 
system installation process executes in a different thread from the console, it 
is possible that the next command might finish before this Console command 
does. If the delay is set at -1, Console will delay until the system console 
screen has processed all the commands in its buffer. 


Example 


Console 'load ne2000 frame=ethernet_802.3 int=3 port=300', 
10 
Console 'bind ipx to ne2000 net=1240000', 3 


These commands load and bind an NE2000™ driver to IPX™. 


Syntax 


CopyFile <recurse flag>, <directory flag>, <empty flag>, 
<attribute flag>, <attributes>, <src var name>, <src file 
spec>, <src vol name>, <src descr>, <dest var name>, <dest 
dir>, <dest vol name>, <dest descr>, [<conditional copy flag>] 


Description 


CopyFile copies files (wildcards are allowed in <src file spec>) from the 
source path to the destination path. 


<recurse flag> (0|1) 





Value Description 





0 Do not copy subdirectories recursively. 





1 Copy subdirectories recursively. 
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<directory flag> (0|1|2|3) 





Value Description 





0 Source is a file. 





1 Source (including <src file spec>) is a directory; copy directory contents 
to destination. 





2 Source and the destination are files (file-to-file copy). <recurse flag> 
must be 0 if <directory flag> is 2 





3 Source (including <src file spec>) is a directory; copy directory contents 
to destination only if that directory already exists on the destination. 





<empty flag> (0|1) 





Value Description 





0 No error if no files are found. 





1 Error if no files are found. 





<attribute flag> (0]1|2) 





Value Description 











0 Use the default file set attributes. 

1 Use the source file's attributes. 

2 Use the attribute specified by <attributes> (must be used to copy to DOS 
drive). 





130 Other Installation Options 


<attributes> 


For a DOS file: 

































































Attribute Meaning 
00000001 Read Only 
00000002 Hidden 
00000004 System 
00000008 Volume Label 
For a NetWare file: 
Attribute Meaning 
00000001 Read Only 
00000002 Hidden 
00000004 System 
00000008 Execute 
00000010 Subdirectory 
00000020 Archive 
00000080 Shareable 
00000700 Smode 
00001000 Transaction 
00004000 Read Audit 
00008000 Write Audit 
00010000 Immediate Purge 
00020000 Rename Inhibit 
00040000 Delete Inhibit 
00080000 Copy Inhibit 
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Reserved path names (<src|dest var name>) are NWSRC, NWDST and 
NWBOOT, the standard source, destination and boot path for NetWare files. 
<dest dir name> can be a null string. 


<conditional copy flag> 





Value Description 





O (or not present) Unconditionally copy this file. 





1 Copy if destination file is not present. 





2 Copy if destination file is not present; if it is, prompt user 
(no version check). 





3 Copy if destination file is not present or if the source file 
version is newer than the destination file version. 





4 Copy if destination file is not present or if the source file 
version is newer than the destination file version; 
otherwise, prompt the user. 





5 Copy if destination file is present (no version check). 





6 Copy if destination file is present and source file version is 
newer than destination file version. 





7 Copy if destination file is present and source file version is 
newer than destination file version; otherwise, prompt the 
user. 





8 Copy if destination file is not present or if source file version 
is newer than destination file version (refresh with new 
files). 





9 Copy only if destination file is present and source file 
version is newer than destination file version (refresh 
existing files). 





Example 
CopyFile 0, 0, 1, O, O, input, *.*, 'NETWARE-1', “NW [1]”, 


output, ee ra vt 


This is a continuation of the examples for “GetPath” on page 141. The user is 
prompted for diskette NW [1], and the diskette is verified by checking for 
volume label NETWARE-1. All files on the diskette are copied to the 
subdirectory the user indicated for output. 
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CopyFloppylmage 


Delay 


Syntax 
CopyFloppyImage <floppy type flag>, <diskette name>, <src var 


name>, <src file spec>, <src vol name>, <src descr>, <dest var 
name>, <dest dir>, <dest vol name>, <dest descr> 


Description 


CopyFloppyImage copies a diskette image file sector by sector to the specified 
drive (destination path which must be a diskette drive). 





Variable Description 





<floppy type flag> (0|1) 0 indicates a 3.5-inch high-density drive. 1 indicates 
a 5.25-inch high-density drive. 





<diskette name> The external label for the diskette. 





Example 


GetPath, dst, 2, 'A:', '' 
CopyFloppyImage 0, “Disk 1", 3.5\WSDOS_1.IMG, '', '', dst, 


vt vt vt 
, , 


The floppy image specified by the source path is copied to the diskette in the 
specified drive. 


Syntax 
Delay <delay in seconds> 
Description 


Delay relinquishes control for <delay in seconds> seconds before returning 
control back to the calling process. Ifa negative value is used, the delay is a 
random value from 0 to the absolute value of <delay in seconds>. 


Example 


Delay '-10' 


This delays randomly from 0 to 10 seconds. 
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DiskReset 


Dismounted CD 


Display_Text_File 


Syntax 
DiskReset <var name> 
Description 


DiskReset tells DOS to rescan the directories on the <var name> floppy drive. 
This is necessary because the drive change interrupt is disabled while 
NetWare has control. 


Example 


Assuming myDir corresponds with A:\ 


DiskReset myDir 


Drive A:\will be rescanned. 


Syntax 
DisMountCD <CD Volume Name> 
Description 


DisMountCD is to be used with PromptForCD (below). It is used to dismount 
a CD volume that has been mounted via the PromptForCD command. 


Example 


DisMountCD ‘CDVolumeName’ 


Syntax 


Display_Text_File <Path>, <Filename>, <Completion Code> 


Description 


Display_Text_File displays an ASCII text file. The user can scroll the text in 
any direction to read the entire contents of the file. Scroll bars automatically 
display if needed. The maximum file size is 30 KB for the file. 
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Display 


DSInst 


Example 


GetPath sys, 1, 'SYS:', '' 
Display_Text_File sys, “license.txt”, ccode 


The completion code will return a 0 (zero) for a successful return. Anything 
else is an error. 


Syntax 


Display <0|1|2>, “...<text>...” 


Description 


Display displays a message, accompanied by a beep if the first argument is 1. 
If the argument is 2, the message is displayed as a copy status. 
Example 


Display 0, “Product XYZ installation is complete.” 


The text is displayed (without a beep), and the user can press Enter to 
continue. 


Syntax 


DSInst <time zone name>, <time server type>, <daylight 
flag>, <daylight start>, <daylight end, <daylight 
offset in seconds>, <tree name>, <tree address>, 
<container object name>, <admin name>, <admin password>, 
<replica flag>, <upgrade bindery flag>, <root server 
flag> 


Description 


DSInst installs the directory with default time synchronization. 











Variable Description 

<time zone name> Time zone name (works as a system SET 
parameter) 

<time server type> Time server type (works as a system SET 
parameter): single, reference, primary, 
secondary 
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Variable 


<daylight flag> 


Description 


1: Daylight savings time exists in this time 
zone 


0: Daylight savings time doesn't exist in this 
time zone 





<daylight start> 


“set parameter” daylight savings time start 
string. For Example First Sunday of April at 
2:00:00 a.m 





<daylight end> 


“set parameter” daylight savings time end 
string. For Example Last Sunday of October 
at 2:00:00 a.m. 





<daylight offset in seconds> 


Typically this is 3600 (seconds per hour), or 
zero if daylight saving time is not applicable. 





<tree name> 


DS tree name 





<tree address> 


Internal IPX address of the SAP server for 
the tree 





<container object name> 


Full DN of container 





<admin name> 


Full DN of Admin object (must have 
supervisor rights on the container) 





<admin password> 


Password for <admin name> 





<replica flag> 


1: Install a replica on this server; 0: don't 
install 





<upgrade bindery flag> 


1: Upgrade the bindery if it exists; O: don't 
install 





<root server flag> 


1: Make this a new tree; 0: don't make this a 
new tree 





Example 


DSInstMST7MDT, SECONDARY, 1, ' (APRIL SUNDAY FIRST 2:00:00 
AM)', ' (OCTOBER SUNDAY LAST 2:00:00 AM)', 3600, URSA, 


FACE3234, 'O=Novell', 


'CN=Admin.O=Novell1', '', 1, 1, 0 


Time services will be installed with this server as a secondary server using 
existing tree name URSA. Directory services will be installed, with this server 
in container O=Novell. This server will have a replica installed, and its 


bindery will be upgraded. 
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EraseFile 


EditNCF 


Syntax 


EraseFile <directory flag>, <var name>, <file spec>, <vol 
name>, <vol descr> 


Description 


EraseFile recursively erases the file or directories indicated in <file spec>. 
Wildcards are acceptable. In NetWare, files can be removed no matter what 
their attributes; in DOS, only normal files can be removed. 


IMPORTANT: Use this command with care to delete only the intended data. 


If <directory flag> is 1, <file spec> must be a directory name; the contents of 
the directory will be deleted, but the directory will not. 


Example 


If myDir corresponds to VOL1:\. 
EraseFile 1, myDir, '', '', '' 


The contents of directory VOL1:\ will be erased. 


Syntax 





EditNCF <ncf path var>, <ncf file name>, <backup ext>, <ccode> 


Description 
EditNCF edits the specified NCF file as follows: 


+ Writes any lines in the EditNCF_ ADDLINE list at the beginning of the 
NCF file. 


+ Deletes any lines that match lines in the addline list. 


+ Comments out any lines containing keystrings in the 
EditNCF_KEYSTRINGS list. 


+ Any other lines are copied unchanged. 
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EditNCF_ADDLINE 


Example 


GetPath startup, 1, 'C:\\NWSERVER', '' 
EditNCF_KEYSTRING '' 

EditNCF_KEYSTRING 'PK411.NIM' 

EditNCF startup, 'startup.ncf', 'bak', ccode 


The contents of C:\NWSERVER\STARTUP.NCF will be searched for a line 
containing PK411.NLM and will be commented out by the EditNCF 
command. Ccode will contain the following: 


0 - Success 

1 - Duplicate Extension 

2 - Open Error 

3 - Read Error 

4 - Write Error 

5 - NCF to Backup Extension Error 
6 - Tmp to NCF Error 


Syntax 


EditNCF_ADDLINE <LineToBeAdded> 








Description 


EditNCF_ ADDLINE adds a line of text to the list of lines to be added at the 
top of the file being edited with EditNCF. 


Example 


EditNCF_ADDLINE '' 
EditNCF_ADDLINE 'LOAD PK411.NIM' 
EditNCF startup, 'startup.ncf', 'bak', ccode 


The first line will clear the ADDLINE list. The second line will add the string 
“LOAD PK411.NLM” to the top of the STARTUP.NCF file. 
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EditNCF_KEYSTRINGS 


Syntax 





EditNCF_KEYSTRINGS <keystring> 








Description 


EditNCF_KEYSTRINGS defines a list of keystrings to be used by EditNCF 
when determining which lines to comment out. (A line will be commented out 
if it contains any of the keystrings). 

NOTE: The list must be terminated with a null string (empty quotes) for the last 


entry. This command can be used multiple times. Each time replaces the previously 
defined list. 


Example 


EditNCF_KEYSTRINGS '' 


EditNCF_KEYSTRINGS 'PK411.NLM', 'ADTRSTFX', 'AUTODUMP', 
"CLSSCRFX', 'EAPURGFX', 'EVNTRPFX', 'GETDIRFX', '' 


EditNCF startup, 'startup.ncf', 'bak', ccode 
The first line clears the KEYSTRING list. The second line adds the strings to 
the list to be commented out of the STARTUP.NCF file. 


ExtractVersionNumbers 


Syntax 


ExtractVersionNumbers <version string>, <major var name>, 
<minor var name>, <revision var name> 





Description 


ExtractVersionNumbers parses a version string and returns the major version 
number, minor version number, and revision number as integers. Version 
string is parsed and leading non-digits are ignored. The variables are filled 
with the major, minor, and revision values for the version string. Ifno revision 
value is in the version string, a zero is returned. If the revision value is a non- 
digit value, a numeric revision value is returned (1.e., A = 1, B = 2, etc.). 


Example 


SetVar version, “v2.11” 


ExtractVersionNumbers version, major, minor, revision 


Installation Scripts for NetWare 139 


FileVersion 


GetDOSServer 


The variable version contain the string “v2.11”. Extract VersionNumbers 
returns a value of 2 in the variable major, a value of 11 in the variable minor. 
And a value of 0 in the variable revision. 


Syntax 


FileVersion <src var name>, <src file spec>, <src vol name>, 
<src descr>, <Module major number>, <Module minor number>, 
<Module rev number>, <Module description>, <return code> 


Description 


FileVersion returns the major, minor, and revision numbers as well as the 
description string of the NetWare Loadable Module (NLM, HAM, CDM, 
LAN, etc.) as long as the return code is 0. 


IMPORTANT: This works only for NetWare Loadable Modules ( that is, it does not 
work with .EXE or .DLL files, etc.). 


Example 


GetPath1, 1, 'SYS:\\SYSTEM’ 


File Version pathi, ‘DS.NLM’, '','”, DSMajor, DSMinor, 
DSRev, DSDesc, DSCode 


Syntax 


GetDOSServer <var name> 


Description 


GetDOSServer returns the default DOS server number in <var name> on 
SFT* III servers. 
Example 


GetDOSServer DOSServer 


The value of the variable DOSServer will be either 0 or 1. If the value is 
anything else, the server is not running SFT II. 
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GetPath 


Syntax 


GetPath <var name>, <path type>, <default>, <prompt>, [<base 
var name>] 


Description 


GetPath prompts the user for a path using the prompt. The prompt string will 
be displayed, with “%s” (like C-language print formatting) being replaced by 
the <default> string. 


The keystrokes to modify will be added to your prompt. Trailing backslashes 
are always removed before the path is displayed. <var name> is a variable 
name that can be used later in a CopyFile command. If <prompt> is a null 
string, the user is not prompted; the path variable is set. If <base var name> 
exists, it will be used as a basis for the new variable (the remote connection 
number will be maintained, etc.). 























<path type> 

Value Description 

1 Allow any path. 

2 Allow floppy only (including remote). 
3 Allow DOS only (including remote). 
4 Allow NetWare local path only. 

5 Allow local floppy only. 

Example 


GetPath input, 1, 'A:', “Files will be copied from %s\\.” 
The user will see the following prompts: 

Files will be copied from A:\ 

Press <F3> to specify a different path. 


Press <F4> to specify a remote path. 





Press <Enter> to continue. 
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Goto 


GotolfEqual 


Syntax 


Goto <label_name> 


Description 


Goto causes execution to continue at the first occurrence of label 
<label_name>. 


The scope of a label is always local to a file set. Therefore, a Goto statement 
cannot transfer execution to a file set different from the current one. 


Example 


Goto Done 
Label Done 


The statement Goto Done will cause execution to continue at the label Done. 


Syntax 





GotolfEqual <larg1>, <arg2>, <label_name> 


Description 


GotolfEqual causes execution to continue at the first occurrence of Label 
<label_name> if <argl1> is equal in value to <arg2>. Both <arg/> and 
<arg2> must be integers. 


The scope of a label is always local to a file set. Therefore, a Goto statement 
cannot transfer execution to a file set different than the current one. 
Example 


GotoIfEqual 0, 1, Error 
Goto Done 
Label Error 


Since 0 is not equal to 1, execution will not continue at label Error. 


NOTE: GotolfEqual performs an integer comparison, not a string comparison. 
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GotolfNEqual 
GotolfGreater 
GotolfLess 
GotolfGrEqual 
GotolfLsEqual 


Is NLM_Active 


Syntax 


GotoIfNEqual <arg1>, <arg2>, <label_name> 
GotolfGreater <argl>, <arg2>, <label_name> 
GotolfLess <argl>, <arg2>, <label_name> 

GotoIFGrEqual <argl>, <arg2>, <label_name> 
GotolfLsEqual <argl>, <arg2>, <label_name> 











Description 


These are identical to GotolfEqual (page 142), except that execution branches 
only if (respectively): 


<arg> not equal to <arg2> 

<arg/> is greater than <arg2> 

<argl> is less than <arg2> 

<argl> is greater than or equal to <arg2> 
<argl> is less than or equal to <arg2> 


The scope of a label is always local to a file set. Therefore, a Goto statement 
cannot transfer execution to a file set different from the current one. 


NOTE: Gotolf* performs an integer comparison, not a string comparison. 


Syntax 
Is_NLM_Active <NLM Name>, <Completion Code> 
Description 


Is NLM_ Active searches the loaded modules list and returns 1 if the NLM is 
loaded, or 0 if the NLM is not present in memory. 


Example 


Is_NLM_ Active “Monitor.nlm”, ccode 
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IsSubString 


Label 


LangVar 


Syntax 


IsSubString <string>, <substring>, <index> 


Description 


IsSubString returns the zero based <index> of <string> where <substring> 
starts, if <substring> is indeed contained within <string>, otherwise <index> 
is -1. 

Example 


IsSubString ‘Little Miss Muffet sat on’, ‘Miss Muffet’, 
index 


In this example, <index> would return as 7. 


Syntax 





Label <label_name> 


Description 


Label serves only as a target of a goto statement with </abel_name>. 


IMPORTANT: The scope of a label is always local to a file set. Therefore, a Goto 
statement cannot transfer execution to a file set different from the current one. 


Example 


Goto Done 
Label Done 


The Goto Done statement will cause execution to continue at Label Done. 


Syntax 


LangVar <default>, <lang var>, <src var dir name>, <src vol 
name>, <src descr> 
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Menu 


Description 


LangVar sets a variable to the number of a language. It starts with <src var dir 
name>, then it looks for a subdirectory whose name is a number that matches 
the current server language number. If the subdirectory is found, </ang var> 
is set to that number; otherwise, </ang var> is set to <default>. 


Example 


Assuming the current language is 6: 


LangVar 4, lang, NWSRC, '', '' 


This command looks in the source install directory for a subdirectory named 
6. Finding it, it sets lang to 6. 


Syntax 


Menu <var name>, <Prompt>, <# of menu options>, <default menu 
option>, <first choice>, <first value>, <second option>, 
<second value> [<third option>, <third value>,] [<fourth 
option>, <fourth value>] 


Description 


Menu command will display a window with the <Prompt> showing in a 
header area. The <choices> will display in a scrolling area below the header. 
The <# of menu options> is 1 based. The <default menu option> is zero based. 
The entire command is terminated without a comma after the final value. 


Example 


Menu done, “Are you ready to continue?”, 2, 0, 


“Yes”, 1, 
“No m 0 
r 


The Menu command displays a box on the screen with the Prompt “Are you 
ready to continue?” Below it the choices are “Yes” and “No.” The “Yes” 
option is highlighted as the default option. Upon selecting the option, the value 
will be placed in the variable. The values must be integers. 
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NLMExec 
NLMExeclO 


Partitions 


Syntax 





NLMExec <block flag>, <command line> 


Description 


NLMExec executes the NLM specified by <command line>. If <block flag> 
is 1, NLMExec waits for the NLM to complete execution, then continues. 
NLMExec is the external command version of the Exec (page 123) command. 
NLMExeclO is identical to NUMExec except it executes the command line on 
the default DOS server on a NetWare SFT III server. See “SetDOSServer” on 
page 149 for more information. 

Example 


NLMExec 1, PINSTALL 


This command executes PINSTALL.NLM and waits for it to finish. 


Syntax 


Partitions <delete flag> 


Description 


Partitions creates NetWare partitions as needed on all available devices. If 
<delete flag> is 1, all existing non bootable partitions will be deleted. If 
<delete flag> is 0, they will be left intact. The minimum allowable partition 
size is 1 MB, according to default rules (see “(@DeletePartition” on page 105). 


Example 


For one existing device with a DOS (active) partition and a NetWare 286 
partition: 


Partitions 1 


This deletes the 286 partition and creates a NetWare partition in the remaining 
space. 
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PromptForCD 


Quit 


Syntax 


PromptForCD <CD Volume Name>, <seconds to mount> 


Description 


PromptForCD is to be used with DisMountCD (above). PromptForCD 
will prompt the user to insert the CD labeled <CD Volume Name> 
into the CD drive and then will attempt to mount the CD volume 
within the <seconds to mount> time frame. 


Example 


PromptForCD ‘CD 1’, 30 


Syntax 
Quit 
Description 


Quit will exit the script processing at this point. No further processing will 
take place. 

Example 

GotolfEqual %{variablel}, %{true}, Continue_On 

Quit 


Label Continue_On 


ReadProductRecord 


Syntax 


ReadProductRecord <productID>, <recordtype>, 
<recorddatavarname>, <ccode> 


Description 


ReadProductRecord reads the record in the products database matching the 
<productID> and <recordtype> specified and returns the corresponding data. 
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Read_Var_File 


SetDir 


This command is the counterpart to the ProductRecord command. See 
“ProductRecord” on page 123 for more information on record types. 
Example 


ReadProductRecord MYPROD, 0, version, ccode 


The command will search the products database and return the value for 
<version> for product 'MYPROD:'. 


Syntax 


Read_Var_File <path>, <filename>, <completion code> 


Description 


Read_Var_File will read the contents of the filename and create variables for 
script processing. The file is an ASCII formatted file with the content as 
follows: 


“Variable l=true” 
“Variable2=false” 
“Variable3=Servername” 


Example 


Read_Var_File “sys:system”, “varfile.txt”, ccode 


NOTE: Ccode will return the file open status. O is success, anything else is an 
error. If the variable to the left contains any spaces, leading or trailing, the spaces 
will become part of the variable name and must be included with the variable when 
referencing it. 


Syntax 


SetDir <var name>, <relative dir>, <vol name>, <vol descr>, 
<attributes>, <0|1>, <rights> 


Description 


SetDir creates directories (if they do not already exist), according to the <var 
name> obtained from GetPath (page 141). The <relative dir> value can be 
null. <attributes> are the attributes to use when creating the directory; 0 
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SetDOSServer 


indicates normal attributes. If the <0| 7> argument is 1, the server container 
object (or everyone) is given <rights> rights to the directory. 

Example 

If myDir corresponds to VOL1:\ 

SetDir myDir, DOC, '', '', 10, 1, O 


The directory VOL1:\DOC will be created and all applicable users will have 
rights to 1t. 


Syntax 


SetDOSServer <engine number>, <ccode> 


Description 


SetDOSServer specifies the <engine number> to be made the default DOS 
server (valid numbers are 0 and 1). This will set the default server used by the 
OS APIs. 


NOTE: DiskReset and GetPath can be directed to a particular |OEngine by first 
setting the DOS server as needed. This allows you to essentially map a path 
variable to a particular |OEngine. From that point on, that path variable will be 
associated with that |OEngine regardless of what the default DOS server is set to. 
Therefore, any commands that use path variables will target the IOEngine 
associated with the path variable rather than the default. 


Example 


SetVar IOEngineNumber, 0 
SetDOSServer IOEngineNumber, ccode 


The server’s default IOEngine 0 will now be the default DOS server. Ccode 
will have a 0 for its value on success and a -1 for a failure. 
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SetLConfigLang 


SetVar 


Syntax 


SetLConfigLang <value> 


Description 


SetLConfigLang looks for the LCONFIG.SYS file in the server boot directory. 
The default server language ID number is changed to <value>. 


Example 


SetLConfigLang 9 


The default server language ID number in the LCONFIGSYS file is changed 
to 9 (Japanese). 


Syntax 


SetVar <variable name>, <variable value>, [<Prompt>] 


Description 


SetVar sets a variable with <variable name> to the <variable value> string 
value. If the value does not exist, one is created. The variable value cannot 
exceed 127 characters in length. 

Example 


SetVar message, “Hello World!” 


This causes a variable to be created with name “message,” and its value set to 
the string “Hello World!” 


NOTE: The Prompt option is only available in version 3.25+. 
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SGotolfEqual 
SGotolfNEqual 
SGotolfGreater 
SGotolfLess 
SGotolfGrEqual 
SGotolfLsEqual 


SpaceCheck 


The SGotolf commands have the same options as the GotoIf commands. The 
SGotolf commands perform a string comparison instead of an integer 
comparison. 


Syntax 


SpaceCheck <path var name>, <value> 


Description 


SpaceCheck looks at <path var name>. If it matches a NetWare volume, 
SpaceCheck checks whether the volume is large enough for <value> bytes, 
and whether the volume has enough free space for <value> bytes. If the 
volume is not large enough, the installation aborts. If there is not enough free 
space, the user is alerted and allowed to continue. 

Example 

Assuming srcVar corresponds to VOL1:\FILES 

SpaceCheck srcVar, 1000000 


Volume VOLI: will be checked for one million bytes of free space. 


NOTE: ICMD.NLM versions 3.25 and older do not support SpaceCheck on DOS 
drives. Newer versions support this drive option. 
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SrchNCF 


ValueSet 
ValueAdd 


Syntax 


SrchNCF <ncf path var>, <ncf file name>, <keystring>, 
<foundline var name> 


Description 


SrchNCF searches an .NCF file for line containing a substring matching 
<keystring> (non case-sensitive). If found, the line of text will be returned; 
otherwise <foundline var name> will be empty. 


NOTE: The same value as not found will be returned if an error is encountered (for 
example, invalid filename, read error, etc). It is assumed that this command will be 
used before calling EditNCF (page 137) which returns a more detailed completion 
code that can be acted on as necessary. 


Example 


GetPath sys, 1, 'SYS:\\', '' 
SrchNCF sys, 'SYSTEM\\AUTOEXEC.NCF', “Load Monitor”, ccode 


The SrchNCF command will search the SYS:\SYSTEM\AUTOEXEC.NCF 
file for the string 'Load Monitor' and return the line number in ccode if found. 


Syntax 


ValueSet <var name>, <value> 
Value Add <var name>, <value> 


Description 


ValueSet sets, and ValueAdd adds to, the numeric contents of variable <var 
name>. 


Example 


ValueSet srcVar, 1 


The variable srcVar is created if it did not exist and is set to 1. 
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Volumes 


Write_Var_File 


Syntax 


Volumes <minimum vol SYS: size in sectors> 


Description 


Volumes creates and mounts volumes on this server, with the volume SYS: 
placed on the first device larger than <minimum volume SYS: size in sectors> 
(512 bytes per sector). Additional volumes, named “VOL1”, “VOL2”, etc., 
will be created on other devices, one per device. 


Example 


For one existing device with 50 MB and a NetWare partition, but no volumes: 


Volumes 51200; 25 MB minimum 


This command creates volume SYS: on the device and mounts it. For more 
information on creating and mounting NetWare volumes, see the Volume 
Management API. 


Syntax 
Write_Var_File <path>, <filename>, <varname>, <var value>, 


<completion code> 


Description 


Write _Var_File will write the varname and var value to the filename specified 
by the path/filename. The file is an ASCII formatted file with contents as 
follows: 


“Variable 1=true” 
“Variable2=false” 
“Variable3=Servername” 
Example 


Write_Var_File “sys:system”, “varfile.txt”, “Variablel”, 
“true”, ccode 


NOTE: Ccode will return the file open status. 0 is success, anything else is an 
error. If the variable to the left contains any spaces, leading or trailing, they will be 
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part of the variable name and must be included with the variable when referencing 
it later. If the filename doesn't exist, it will be created. The varname and var value 
will then be written. If the file does exist, the varname and var value will be 
appended to the contents of the file. 


External Command Programming Interface 


The external command programming interface contains the functions 
described below. 


IMPORTANT: These functions require ICMD.NLM 2.18 or later. 


ICMDSetVar 
Use the ICMDSetVar function to set a script variable programmatically. 
Function 
int ICMDSetVar (char *variableName, char *variable Value) 
*variableName: Pointer to name of variable to set 
*variableValue: Pointer to string representing value of variable being set 
Return 
0 if successful; non-zero error code if unsuccessful. 
Description 
ICMDSetVar is a function exported by ICMD.NLM that another NLM can 
call (for instance, in a blocking NLMExec command). This lets the NLM set 
a variable within a script being executed by ICMD.NLM so the NLM can 
communicate with the script, changing the control flow, etc. 
Example 


If MYNLM.NLM has code as follows: 
ICMDSetVar (“mynlmvar”, “hello world”); exit(); 
and the script looks like this: 


NLMExec 1, mynlm 


Display 0, “Information: %{mynlmvar}” 
then this popup text box would be displayed: 


Information: hello world 
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ICMDGetVar 


Function 


Return 


Description 


Example 


Use the ICMDGetVar function to get the value of a script variable. 


int ICMDGetVar (char *variableName, char *variable Value) 


*variableName: Pointer to name of variable 
*variableValue: Buffer containing value of variable; must be at least 128 
bytes 


0 if successful; non-zero error code if unsuccessful or if variableName does 
not exist. 


ICMDGetVar is a function exported by ICMD.NLM that another NLM can 
call. This lets the NLM set a variable within a script being executed by 
ICMD.NLM so the NLM can communicate with the script, changing the 
control flow, etc. 


If a script looks like this: 


SetVar myvar, “Hello” 


NLMExec 1, mynlm 


and if MYNLM.NLM has code as follows: 


char buffer[128]; 
ICMDGetVar (“myvar”, buffer); 


then the value in buffer would be the null-terminated string: 


“Hello”. 
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External Command Variable Substitution 


A variable, such as the value returned by GetPath (page 141), can be used 
inside any quoted string within an executed external command. The variable 
is global. It goes out of scope only when the command processor is replaced 
by a different one. The variable can be dereferenced explicitly by an 
expression % {<var name>} within another string. 





























Variable Description 
NWSERVER The name of the server the script is processing on. 
NWSRC Source path where script is found. 
NWDST Destination path (where server will boot from). 
NWBOOT Current path (where server was booted from). 
NWLANG Language number (4 = English, etc. ). 
COUNTRY Country ID (DOS country specifier). 
CODEPAGE Codepage number (DOS code page specifier). 
OSTYPE NetWare operating system type: 

0 - Native 

1 - OS/2 

2- SFT Ill 
LOADERTYPE Type of loader used to start NetWare: 

1-DOS 

2 - OS/2 

3 - Windows 3.1 





SERVCONFIGTYPE 


NetWare server configuration: 
0 - Native 
1 - SFT III I/O Engine 
2 - SFT III MS Engine 





SFTLEVEL 


Level of active System Fault Tolerance for NetWare. 





OSMAJORVERSION 


The major version number for the NetWare OS. 





OSMINORVERSION 


The minor version number for the NetWare OS. 





OSREVISION 
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The revision level for the NetWare OS. 


Example 


All path variables, including the predefined ones, allow subfield specifiers in 
the form <path var>.<specifier>. 


























<path var> <specifier> 

PATH String containing the actual path. 
VOL Disk volume name. 

PROMPT Disk volume prompt. 

TYPE Path type. 

SUBTYPE Path subtype. 

CONN Connection number (hex). 
ENGINE Engine number. 

TYPE Values: 


1 local server 

2 remote server 

3 local DOS 

4 remote DOS (via RCONSOLE) 





SUBTYPE Values: 
0 unknown 
1 floppy 
2 cd 
3 network 
4 other 





NLMExec 1, 'Pinstall %{NWLANG} S(NWSRC.CONN) ' 


If the server language is English, and the connection number for NWRSC is 
5, it is as if the following were typed on the system console: 


‘load PINSTALL.NLM 4 5' 
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Installation NLM Command Line Options 


Command line options can be preceded by '-', but this is not required. 


IMPORTANT: These options are not intended for general distribution; they apply 
only to the NetWare installation NLM. Other Switches are not guaranteed to be 
supported in all versions. 


User-Documented Switches for NetWare Installation 








Switch Description 
DSREMOVE Allows absolute removal of DS. 
R Allows license replacement. 


Switches Helpful for Install Script Writers 











Switch Description 

DELAY Wait until execution of AUTOEXEC.NCF is complete 
before activating screen. 

NOSTATUS Suppress status bar display in batch mode. 

A= NNNNNNNN:000000000000:SSSS or 
XXX. XXX XXX 


source path IPX address: N hex network (8 chars): O 
hex node (12 chars): S hex socket 


source path IP address: XXX decimal value (1-3 chars) 




















B= Batch file spec. 

D= Destination path in DOS for SERVER.EXE, etc. 

E= Error file spec. 

O= Overwrite existing files flag; 1: always, 2: never 
overwrite. 

S= Source path DOS specifier. 

W= Overwrite newer files flag; 1: always, 2: never 
overwrite. 
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Other Switches 



































Switch Description 

MDEBUG Memory debug. 

TRANSPORT Transport layer type. (IPX is the default). 
IPX 
TCP 
UDP 

C= Source path remote context. 

DS= Specifies that NDS authentication will be used. 
If command is not present, the connection is made through 
the bindery. 

F= Front end flag. 

Q simplified mode 

T calculate file set totals 

V suppressed delayed init (DELAY) 
X allow more DS options 

K= Default startup.ncf file spec. 

L= Mode of installation. 

N= Source path remote server spec. 

P= Source path remote user password. 

U= Source path remote user name. 

Z= Source path remote tree. 
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NetWare 4.1 Remote Installation Wrapper 


You can use NetWare installation to remotely install a product that was not 
originally intended for remote installation. 


1 Create a wrapper script that copies the associated files to the server before 
executing PINSTALL.NLM. 


Make sure the system volume is large enough to contain the scratch files, 
even in local install cases. 


In the example below, the directory layout is as follows on the diskette: 
\ (root) 


PINSTALL.IPS 
PINSTALL.NLM 
other files... 


The contents of file PINSTALL.IPS appears as follows: 


command icmd 

getpath dest, 1, 'sys:system\\tmp'’, " 

copyfile 0, 0, 0, 0, 0, NWSRC, '*.*',",", dest, ", "," 

; Additional copyfile commands might be needed to copy all diskettes 
; See filedata.doc for details. 

nlmexec 1, 'sys:system\\tmp\\pinstall' 

erasefile 0, dest, ","," 


PINSTALL.IPS script causes ICMD.NLM to be loaded. A path variable 
dest is set, all files are copied to that location, PINSTALL.NLM is 
executed, then the files are erased. 


Load INSTALL.NLM. 
Click Product Options > Install a Product Not Listed. 
Press F3. 


a AO N 


Enter the remote path: 


server_name\vol_name: path 
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NetWare Installation Command Version Availability 


NetWare Install Commands 


Command 


NetWare 4.10 


NetWare 4.11 


The following tables list the available NetWare installation and external 
installation commands. 


NetWare for Small NetWare 5 and 
Business NetWare 6 





@CDName 


X X 





@DeletePartition 





@Driver 





@FileSet 





@lncludeFile 





@MessageFile 





@Other 


X|X| XxX, XxX, X| X] X 


X|X| XxX, X| X| X|] X 





@StartAppObject 





@StartSchemaMod 





@SyntaxVersion 





@TimeZone 





@TranslateModule 





(Version 





Command 





CopyDriverToServer 





CopyDriverToStartup 





CopyToServer 





CopyToStartup 


x) XJ X, X] XI X| X| X| X 


X] XI X] X| X| X| X| X| X| X 


X] XI X, X| X| X| X| X|] X| X|] X] X] X| X] Xx X| X 


X| X] X| X|] X| X|] X] X|] X| X 
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Command 


NetWare 4.10 


NetWare 4.11 


NetWare for Small 
Business 


NetWare 5 and 
NetWare 6 





Exec 


X 


X 





ProductRecord 





RegisterLanguage 





SaveLanguageFile 





Spawn 


x) eK) KI) XxX] XxX 


x) Ki) KI) XxX] XxX 


NetWare External Install Commands 


Command 


Version of ICMD.NLM 


2.00 


2.18 


X 
X 
X 
X 


3.20 


x] Xx] X] X 


3.25 





Activate 





AppendFile 





CheckFile 





Config 





Console 





CopyFile 





CopyFloppylmage 





Delay 





DiskReset 


X X|X|x X| XxX 


xX] XxX] X X] X| X| X| X| X 


x) XxX] X] X] XI X| X| X| X 





Display_Text_File 





Display 


x< 





DSInst 





EditNCF 





EditNCF_Addline 


x) Ki] XxX] XxX 


x) XI X[| X| X|] X] X| X] X|] X| X] Xx X| X 
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Command 


Version of ICMD.NLM 


2.18 


3.20 3.25 





EditNCF_Keystrings 





EraseFile 





ExtractVersionNumbe 


rs 


x< 





GetDOSServer 





GetPath 





Goto 





GotolfEqual 





GotolfNEqual 





GotolfGreater 





GotolfLess 





GotolfGrEqual 





GotolfLsEqual 


X|X| XxX] X| X| X] X] X 


XI XI X] X| X| X| X|] X| X 





Is_NLM_Active 





Label 





LangVar 





Menu 





NLMExec 


X XxX XxX] X 





NLMExec_IO 





Partitions 


X XI XxX) XxX, XxX] XxX 





Quit 





ReadProductRecord 





Read_Var_File 


X| XI X, X| X] X| X] X] X|] X] X| X| X|] X] X| X| X] X|] X 
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Command Version of ICMD.NLM 


















































2.00 2.18 3.20 3.25 
SetDir X X X X 
SetDOSServer X X 
SetLConfigLang X X X X 
SetVar X X X X 
SgotolfEqual X X X 
SgotolfNEqual X X X 
SgotolfGreater X X X 
SgotolfLess X X X 
SgotolfGrEqual X X X 
SgotolfLsEqual X X X 
SpaceCheck X X X X 
SrchNCF X X 
ValueAdd X X X X 
ValueSet X X X X 
Volumes X X X X 
Write_Var_File X 
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